A Mozilla Tudásbázisa továbbra is nyitva áll mindenki előtt, aki hozzá szeretne járulni. Bárki beküldhet egy kisebb javítást a támogatási cikkeink javítására vagy frissítésére anélkül, hogy külön engedélyekre lenne szüksége.
Ez a dokumentum az új tartalomkérések és a nagyobb frissítések munkafolyamatát írja le, amelyeket a Bugzillán keresztül koordinálnak. Ezek a kérések más folyamatot követnek, mert gyakran igényelnek együttműködést a termékcsapatokkal és más érdekelt felekkel.
Ha nem biztos benne, hogy melyik munkafolyamat vonatkozik a változtatására, kérjük, olvassa el az alábbi Ökölszabály szakaszt, vagy nézze meg a Kisebb és nagyobb változtatások című részt, hogy megértse, melyik kategóriába tartozik a javasolt változtatás.
Tartalomjegyzék
Miért a Bugzilla?
A Bugzillát használjuk az új tartalomkérésekkel és a nagyobb frissítésekkel kapcsolatos megbeszélések koordinálására, mivel ez a folyamat gyakran több érdekelt felet is érint.
Egyetlen együttműködési tér használata segít biztosítani, hogy a beszélgetések átláthatóak és minden érintett számára hozzáférhetőek maradjanak. Szándékosan a Bugzillát használjuk a Tudásbázis-cikkek megbeszélései helyett, mert sok termékérdekeltünk már a normál munkafolyamatuk részeként a Bugzillában dolgozik, míg viszonylag kevesen ismerik a Tudásbázis megbeszélési rendszerét.
A Bugzilla emellett egyértelmű feladat-tulajdonjogot és előrehaladás-követést is biztosít. Mivel a tartalomkészítés a Mozilla munkatársai és a közösségi közreműködők közös erőfeszítése, fontos, hogy mindenki könnyen láthassa, ki a felelős egy kérésért, milyen döntések születtek, és milyen munka van még hátra. Ez segít elkerülni a párhuzamos munkavégzést, csökkenti a zűrzavart, és megkönnyíti a kiadással kapcsolatos dokumentáció ütemezésének betartását.
Ökölszabály
Általános szabályként felteheti magának a következő kérdést:
Ez a változtatás igényel-e hozzájárulást vagy jóváhagyást a termékcsapattól?
- Ha igen, hozzon létre vagy dolgozzon egy Bugzilla-jegyen keresztül, hogy a megfelelő érdekelt felek részt vehessenek a megbeszélésben.
- Ha nem, általában szabadon beküldheti a változtatást közvetlenül kisebb Tudásbázis-frissítésként.
Más szóval, ha a javasolt változtatás nem igényli a termék érdekelt feleinek bevonását, és egy kisebb javítás hatálya alá esik, akkor nem kell a Bugzillán keresztül mennie.
Miért létezik ez a folyamat
Ez a folyamat a közösségi hozzájárulások támogatását szolgálja. Segít nekünk:
- A kiadási határidők védelme
- A felelősségi körök és az elszámoltathatóság tisztázása
- Az egészséges együttműködés megőrzése
- A nem egyértelmű elvárások okozta súrlódások elkerülése
Nagyra értékeljük a közreműködők szakértelmét. A közösségen belüli, régóta fennálló termékismeret hihetetlenül értékes. Ugyanakkor a termékmegjelenésekhez és a funkciók közötti együttműködéshez kötődő tartalmi munka egyértelmű felelősséget, kiszámítható időkereteket és strukturált koordinációt igényel, hogy biztosítani tudjuk a pontos és hasznos tartalmak időben történő szállítását a Mozilla globális felhasználói bázisának támogatására.
A Bugzillán keresztüli tartalomkérések munkafolyamata
A következő folyamat a Bugzillán keresztül benyújtott új tartalomkérésekre és nagyobb frissítésekre vonatkozik.
A tartalomkérések általában két kategóriába sorolhatók:
- On-train kérések: A Firefox ütemezett kiadásához kötött tartalom. Ezek a kérések időérzékenyek, és követniük kell a kiadási ütemtervet.
- Off-train kérések: Olyan tartalom, amely nem kötődik a Firefox ütemezett kiadásához. Ezeknek a kéréseknek még lehet céldátumuk, de általában nagyobb rugalmasságot tesznek lehetővé.
- A teljes előnézethez nyissa meg a képet egy új lapon.
1. Benyújtás
- Minden nagyobb tartalomfrissítést egy Bugzilla-jegyen keresztül kell benyújtani.
2. Osztályozás és hozzárendelés
- Osztályozás: Minden új tartalomkérés egy osztályozási folyamaton megy keresztül a prioritás és a hozzárendelés meghatározása érdekében. Az osztályozás hetente, csütörtökön történik.
- A közreműködők számára nyitott tartalomkéréseket a Bugzillában a sumo-contributors kulcsszóval jelölik. Ha szeretne segíteni valamelyik kérésben, jelezze érdeklődését közvetlenül a Bugzilla-jegyen.
- Hozzárendelés: A CX-csapat egyik tagja vagy egy közreműködőhöz, vagy egy műszaki íróhoz rendeli a hibát. A megbízás után a közösségi menedzser vagy a CX-csapat egy másik tagja végigvezeti Önt a folyamaton. Kérjük, ne kezdje el a vázlatkészítést, amíg a CX-csapat egy tagja nem erősíti meg a megbízását.
- Időbeli elvárás: Az osztályozás hetente történik, és a közreműködők a megbízási kérelmükre öt munkanapon belül számíthatnak válaszra.
- On-train kérések: Az on-train kérések hozzárendelése időérzékeny. Ha egy kiadással kapcsolatos kérés nyitva áll a közreműködők előtt, de a következő osztályozási ciklus (5 munkanap) után is hozzárendelés nélkül marad, a CX-csapat hozzárendelheti egy műszaki íróhoz, hogy a kiadási ütemterv ne késsen.
- Off-train kérések: Az off-train kérések általában nagyobb rugalmasságot tesznek lehetővé, és a kért határidőtől függően hosszabb ideig is elérhetőek maradhatnak a közreműködői hozzárendelésre.
3. Tartalomkészítés
- Tartalomvázlat: A munka megkezdése előtt gondosan tekintse át a jegyet, hogy megértse a kérést, a hatókört, a célkiadást vagy a határidőt, és a várt eredményt.
- Miután a hibát Önhöz rendelték, elkezdheti a tartalom létrehozását. Ha a termékcsapat biztosít egy vázlatot, használja azt kiindulási pontként. Ellenkező esetben elkezdheti a tartalom megfogalmazását a Google Docsban. Ha a Google Docs nem opció, a vázlatot közvetlenül a Bugzilla-jegyhez csatolhatja felülvizsgálatra.
- Ne felejtse el közzétenni a vázlatra mutató hivatkozást a Bugzilla-jegyben, és állítsa be a dokumentum engedélyeit úgy, hogy az érdekelt felek hozzászólhassanak.
- Tartalom jóváhagyása: Szorosan működjön együtt a kérelmezővel vagy a termék érdekelt feleivel annak érdekében, hogy a cikk teljes és pontos legyen. Ha hiányzik a munka elvégzéséhez szükséges információ, használja a „Request information from…” opciót a Bugzillában további részletek gyűjtéséhez.
- A Bugzilla űrlap leírásának utolsó sorában ellenőrizheti, hogy a vázlathoz azonosítottak-e hivatalos jóváhagyót.
- Időbeli elvárás:
- On-train kérések: Magas prioritásúként kell kezelni. Hacsak a haladást nem akadályozzák más érdekelt felektől való függőségek, a CX-csapat újra hozzárendelheti az on-train kéréseket, ha egy érdemi vázlat nem áll készen a felülvizsgálatra a hozzárendelést követő egy héten belül vagy a célkiadás napja előtt egy héttel. Ez segít biztosítani, hogy a tartalom időben elkészüljön a kiadásra.
- Off-train kérések: A vázlatnak általában legalább egy héttel a kért határidő előtt készen kell állnia az érdekelt felek általi felülvizsgálatra.
- Eszkaláció:
- Ha úgy gondolja, hogy nem fogja tudni tartani a várt határidőt, kérjük, a lehető leghamarabb értesítse a CX-csapatot a Bugzilla-jegy frissítésével vagy a CX-csapat egyik tagjával való közvetlen kapcsolatfelvétellel. A korai kommunikáció időt ad nekünk a terv módosítására vagy további támogatás keresésére a közzététel késleltetése nélkül.
- Ha nem tudja beszerezni a szükséges információkat a kérelmezőtől, forduljon a CX-csapat azon tagjához, aki a hibát hozzárendelte, hogy segítséget kapjon a szükséges információk beszerzéséhez.
4. Tartalom közzététele
- Tartalom közzététele: Miután a vázlat véglegesítésre és az érdekelt felek által jóváhagyásra került, a tartalmat új változatként benyújthatja a tényleges Tudásbázis-cikkhez.
- Ne feledje, hogy a Tudásbázisunk egyéni wiki-szintaxist használ, ezért győződjön meg róla, hogy a tartalma helyesen van formázva, amikor a Google Docs-ból vagy más, a vázlatkészítéshez használt eszközből átviszi.
- Tartalom felülvizsgálata: A közreműködőknek meg kell várniuk, amíg a Tudásbázis-változatukat egy munkatárs vagy a szerzőtől eltérő Tudásbázis-felülvizsgáló felülvizsgálja. Ebben a szakaszban a felülvizsgálat elsősorban a minőségbiztosításra és a megfelelő jelölőnyelvre összpontosít, nem pedig a mögöttes termékinformációk pontosságának érvényesítésére.
- Időbeli elvárás:
- On-train kérések: A Bugzilla-jegy megadhat egy tervezett közzétételi dátumot, amely összhangban van a Firefox kiadási ütemtervével. Kérjük, küldje be a Tudásbázis-változatot felülvizsgálatra legalább két nappal a célzott közzétételi dátum előtt, hacsak a haladást nem akadályozták más érdekelt felektől való függőségek. Ez elegendő időt ad a felülvizsgálóknak a végső minőségi és jelölőnyelvi felülvizsgálat elvégzésére anélkül, hogy a kiadási határidőt veszélyeztetnék.
- Off-train kérések: A közzétételnek a Bugzilla-jegyben megállapodott határidőt kell követnie.
- Eszkaláció: Ha segítségre van szüksége egy Tudásbázis-változat felülvizsgálatához, kapcsolatba léphet a Tudásbázis-felülvizsgálókkal a kb-reviewers@mozilla.com e-mail címen.
- Jegy lezárása: Miután a Tudásbázis-cikk megjelent, a Bugzilla-jegy lezárható a Resolved — Fixed (Megoldva — Javítva) megjelöléssel.
A tartalom jóváhagyásának és a tartalom felülvizsgálatának megértése
Történelmileg a Tudásbázis közreműködői csak a Tudásbázis felülvizsgálati folyamatát ismerik, ahol bárki, aki rendelkezik Tudásbázis-felülvizsgálói engedéllyel, felülvizsgálhatja és jóváhagyhatja vagy elutasíthatja a cikkváltozatokat.
A Bugzillán keresztül történő munkavégzés során azonban két külön ellenőrzőpont van:
- Tartalom jóváhagyása: A megfelelő termékérdekeltek végzik a tartalomkészítési folyamat során a Bugzillában.
- Tartalom felülvizsgálata: A Tudásbázis felülvizsgálói végzik a cikk közzététele előtt.
Bár mindkettő fontos, különböző célokat szolgálnak.
Tartalom jóváhagyása az érdekelt felek által
A tartalom jóváhagyásának elsődleges célja a tartalom lényegének és szándékának érvényesítése a termék érdekelt feleivel. Ez magában foglalja annak biztosítását, hogy a tartalomtervezet:
- Műszakilag pontos és tükrözi a termék tervezett viselkedését
- Összhangban van a jóváhagyott termékterminológiával és elnevezési konvenciókkal
- Összhangban van a Mozilla márka hangjával és üzeneteivel
Tartalom felülvizsgálata a Tudásbázis felülvizsgálója által
A tartalom felülvizsgálata kiegészíti a jóváhagyást azáltal, hogy a cikk minőségére és megjelenítésére összpontosít. Ebben a szakaszban a Tudásbázis felülvizsgálói ellenőrzik, hogy a cikk:
- Helyes szintaxist és formázást használ, beleértve a wiki jelölőnyelvet
- Világos, jól strukturált és könnyen követhető
- Összhangban van a Mozilla szerkesztői és tartalmi irányelvekkel
Ez a két lépés együttesen segít biztosítani, hogy minden cikk műszakilag pontos és a felhasználók számára könnyen érthető legyen a közzététel előtt.
További irányelvek a közreműködők számára
- A megbízások méltányossága
- Azok a közreműködők, akik közvetlen kapcsolatban állnak a termékcsapatokkal, már a hivatalos benyújtás előtt tudomást szerezhetnek a közelgő kérésekről. Kérjük azonban, hogy ne kezdje el a munkát, és ne kérjen megbízást, amíg a tartalomkérést nem hozták létre és nem osztályozták. Ez biztosítja, hogy a hozzájárulási lehetőségek minden közreműködő számára nyitottak és méltányosak maradjanak.
- Az osztályozási folyamat tiszteletben tartása
- Kérjük, hagyjon a CX-csapatnak teljes 5 munkanapos osztályozási időszakot a Bugzilla-jegyek áttekintésére és kiosztására. Kerülje a megbízási döntések kérését vagy sürgetését ezen időszak lejárta előtt.
- A rendelkezésre állás változásainak közlése
- Megértjük, hogy váratlan helyzetek adódhatnak. Ha nem tudja tartani a vállalt határidőt, kérjük, a lehető leghamarabb értesítse a CX-csapatot, hogy ennek megfelelően tudjunk módosítani.
- A Bugzilla-jegyek újranyitásának szabályzata
- Kérjük, ne nyisson újra egy megoldott Bugzilla-tartalomkérési jegyet olyan változatok felülvizsgálatának kérésére, amelyek nem kapcsolódnak közvetlenül az eredeti kéréshez. A kapcsolódó frissítésekhez az újranyitás helyett adjon hozzá új megjegyzést a meglévő jegyhez. Ha nincs jogosultsága hozzászólni, kérjük, eszkalálja kérését a kb-reviewers levelezőlistára (lásd alább).
- Az ezen szabványnak nem megfelelő jegyek újranyitása a kérés elutasítását eredményezheti. Kérjük, kövesse a Bugzilla Etiquette szabályait a produktív és tiszteletteljes együttműködés fenntartása érdekében.
- Sürgős felülvizsgálati kérelmek
- Ha egy új cikk vagy egy változat gyorsabb átfutást igényel, például sürgős termékváltozás, folyamatban lévő incidens vagy kritikus pontatlanság miatt, e-mailt küldhet a kb-reviewers@mozilla.com címre, hogy gyorsított felülvizsgálatot kérjen.
Munkára váró tartalomkérések keresése
A közreműködőket arra ösztönözzük, hogy vegyenek részt a Bugzillán keresztüli tartalomkérésekben, amennyiben azok megfelelnek a következő szakaszban leírt kritériumoknak. Így kereshet bejövő tartalomkéréseket:
- Kézi figyelés
- Szemmel tarthatja az új tartalomkéréseket a hozzá nem rendelt tartalomkérések listájának ellenőrzésével. Ha talál egy kérést, amelyen szívesen dolgozna, egyszerűen hagyjon egy megjegyzést a hibajegyben, hogy tudassa a CX-csapattal, hogy érdekli.
- Az osztályozás után a közösségi hozzájárulásra nyitott tartalomkéréseket a Bugzillában a sumo-contributors kulcsszóval címkézik. Ezzel a kulcsszóval nyomon követheti a folyamatban lévő kéréseket, amelyek a közreműködők számára elérhetőek.
- Maradjon naprakész
- Ha értesítéseket szeretne kapni az új tartalomkérésekről, fontolja meg a Knowledge Base Content komponens figyelését a Bugzillán. Ehhez lépjen a Bugzilla-profiljára → Profil és beállítások szerkesztése → Komponensfigyelés. Válassza a support.mozilla.org terméket a termékválasztásnál, válassza a Knowledge Base Content komponenst a Component mezőben, és kattintson a Hozzáadás gombra a változtatások mentéséhez.
Hozzárendelési kritériumok
Egy tartalomkérés akkor rendelhető egy közreműködőhöz, ha megfelel a következő feltételeknek:
- Nem tartalmaz bizalmas információkat
- A zárolt információkat vagy érzékeny tartalmat tartalmazó tartalomkérések a munkatársak tulajdonában maradnak.
- Nem jár szoros belső függőségekkel
- Az üzenetküldési érzékenységet, megfelelőségi felülvizsgálatot vagy fejlődő specifikációkat tartalmazó, és a jogi, marketing- és kommunikációs, biztonsági vagy külső partnerekkel való aktív koordinációt igénylő kérések szintén a munkatársaknál maradnak.
- Nem kapcsolódik fizetős termékekhez
- Az előfizetéses termékekkel és fizetős funkciókkal kapcsolatos tartalomkéréseknek a jogi, megfelelőségi, tesztelési és funkciók közötti koordinációs követelmények miatt a munkatársak tulajdonában kell maradniuk. Ezek a kérések gyakran tartalmaznak szerződéses, számlázási vagy kiadásérzékeny információkat, amelyek központi elszámoltathatóságot igényelnek.
- Nem időérzékeny
- Az 5 napnál rövidebb átfutási idejű tartalomkérések a munkatársaknál maradnak, hogy biztosítsák az időben történő szállítást és a kiadási ütemtervekhez való igazodást.
- Közreműködői kapacitás
- A közreműködők egyidejűleg legfeljebb 3 aktív megbízásra korlátozódnak. Ez segít biztosítani a koncentrált végrehajtást és megelőzni a munkaterhelés egyensúlyhiányát. Tudomásul vesszük, hogy egyes kérések technikai függőségek miatt késhetnek. Ha egy kérés több mint két hétig a termékoldali függőségek miatt blokkolva marad, a jegy inaktívnak (elavultnak) tekinthető, és kizárható a közreműködői munkaterhelési elvárásokból.
További pontosítások:
- Ez csak a Bugzillán keresztül érkező kérésekre vonatkozik, és nem vonatkozik a kisebb Tudásbázis-javításokra.
- Ez nem vonatkozik a common forum responses létrehozására.
- A közzétett tartalomért a végső felelősség a munkatársakat terheli.