[ubuntu-hu] Karmic közösségi dokumentáció

László Torma tormail at gmail.com
2009. Okt. 16., P, 18:37:44 BST


Sziasztok!

Már 2 hét sincs az Ubuntu következő kiadásának megjelenéséig, úgyhogy
itt az ideje, hogy komolyan foglalkozzunk a közösségi doksival is. Ha
valaki esetleg nem tudná, konkrétan erről van szó:
http://sugo.ubuntu.hu/community-doc/

Bár a főoldalról még nem érhető el közvetlenül, de már szép lassan
gyülekeznek a Karmichoz tartozó doksik is:
http://sugo.ubuntu.hu/community-doc/karmic/index.html

Mint az látható, ugyan még nem végeztünk a dokumentáció
aktualizálásával, de időarányosan nem állunk rosszul. Viszont ez csak
akkor igaz, és akkor leszünk kész időre, ha az előttünk álló 2 hétben
sem lógatjuk a lábunkat. Segíteni pedig akkor is tudsz, ha éppen nem
vagy tagja a dokumentációs csoportnak. Az alábbiakban azokat a
tennivalókat láthatjátok, amiben bárki részt tud venni, akkor is, ha
nem tagja a csoportnak.

1. Hibák keresése az új dokumentációban:
http://sugo.ubuntu.hu/community-doc/karmic/index.html
Talán ebbe a legkönnyebb bekapcsolódni, ugyanakkor ez az egyik
legfontosabb feladat. Mit is kell itt keresni? Egy doksiban sokféle
hiba lehet, például helyesírási, nyelvhelyességi, technikai jellegű
(például hibás link, összecserélt vagy hiányzó képernyőkép), tartalmi
jellegű (kimaradt egy fontos lépés, valamit nem úgy kell megoldani
szépen, stb.), vagy avulásból fakadó (az új kiadásban valami másképp
működik, mint a korábbiban, vagy megváltozott egy csomag neve, ezt
azonban a dokumentáció nem követte le). A feladat az, hogy minden
ilyen hibát felismerjünk, és kijavítsunk, lehetőleg még a Karmic Koala
megjelenése előtt. Ha szeretnél ebben segíteni, egyszerűen nézd át a
doksikat, és ha felfedezel valamilyen hibát, azt jelentsd itt:
https://bugs.launchpad.net/ubuntu-hu-doc

2. Átfedések keresése a dokumentációban
Ez talán egy kicsit összetettebb feladat, de szintén nem igényel sem
speciális jogosultságokat, sem különösebb rutint: a feladat az, hogy
kiszűrjük a párhuzamosságokat a hivatalos és a közösségi dokumentáció
között, és ami már megtalálható a hivatalos doksiban, arról ne
tartsunk feleslegesen karban közösségi útmutatót is. A hivatalos
útmutatót itt találjátok:
http://sugo.ubuntu.hu/9.10/html/hu.html

Ennek egy része (például a kiszolgálókra vonatkozó fejezetek) még
angolul vannak, azonban hamarosan ezeknek is elkészül a honosítása.
Vagyis bármi, ami megtalálható itt, az nem kell a közösségi doksiba.
Ez alól egyetlen kivétel van, ez pedig a leggyakrabban keresett
megoldások rész:
http://sugo.ubuntu.hu/community-doc/karmic/main/basic/faq.html
Ez a rész tömören leírva gyűjti a tipikus problémákat, így itt nem
gond, ha máshol esetleg ugyanaz részletesebben leírva is szerepel.

Fontos, hogy nem azt kell nézni, hogy pontosan ugyanaz van-e leírva a
két doksiban (a legtöbbször nyilvánvalóan nem), hanem azt, hogy ha
ugyanazt a problémát a hivatalos doksi alapján is meg lehet oldani,
akkor nincs szükség az azzal párhuzamos közösségire.

3. Átfedések a dokumentációban - Mélyvíz
Még mindig az átfedéseknél maradunk, de ez egy különösen szép feladat,
így mindenképpen szerettem volna külön pontot szentelni neki. A
KVM-ről van nekünk egy ilyen útmutatónk:
http://sugo.ubuntu.hu/community-doc/jaunty/main/virtual/kvm.html

Míg a hivatalos dokumentáció ugyanezt a témakört így tárgyalja:
http://sugo.ubuntu.hu/9.10/html/serverguide/hu/virtualization.html

Az viszonylag jól látható, hogy a kettő meglehetősen eltérő utat
követ, hiszen a mi útmutatónk közvetlenül a KVM-et rugdossa, míg a
hivatalos doksi a libvirtet, és az ahhoz kapcsolódó eszközöket hívja
segítségül. A feladat az lenne, hogy első körben meg kellene nézni,
hogy a mi útmutatónk funkcionalitásban ad-e valami pluszt a hivatalos
útmutatóhoz képest: vagyis van-e olyan dolog, amit a hivatalos
útmutatót követve bizonyosan nem tudunk megcsinálni, ellenben a
közösségit követve igen. Ha van ilyen, akkor végig kell gondolni, hogy
mindez hogyan illeszkedik a hivatalos doksi által követett sémába, és
hogyan lehetne olyan új útmutatót írni erről a témáról, ami már a
hivatalos utat követi. Illetve azt is végig kell gondolni, hogy
egyáltalán szükség van-e erre.

Ehhez a témához kapcsolódóan van még egy útmutatónk:
http://sugo.ubuntu.hu/community-doc/karmic/universe/virtual/kvm-ubuntu.html
Ez kifejezetten csak arról szól, hogy egy Ubuntut hogyan tudunk
telepíteni virtuális gépre, és ott próbálgatni. Erre az útmutatóra
mindenképpen szükségünk van, hiszen a különböző Alpha/Beta kiadások
bejelentéseiben hivatkozunk rá, hogy így lehet kipróbálni könnyen és
kockázat nélkül a fejlesztés alatt álló kiadást. Így az is lehetséges,
hogy a hivatalos útmutató, és ez az útmutató együtt összességében
elégséges. Arra viszont nem igazán van lehetőség, hogy ezt a
bővítgessük, hiszen épp az a lényege, hogy tömör és csak a lényegre
szorítkozik.

4. Ha tagja vagy a dokumentációs teamnek, és szeretnél aktívan részt
venni a dokumentáció körüli munkában, kérlek, vedd fel ulyssesszel
vagy velem a kapcsolatot, és egyeztessünk, hogy össze tudjuk hangolni
a tennivalókat, és ne dolgozzunk egymásnak keresztbe.

Ha bármilyen egyéb kérdés lenne a közösségi dokumentációval, illetve
az ehhez kötődő feladatokkal kapcsolatban, akkor azt nyugodtan
kérdezzétek meg itt, a közösségi levelezőlistán, hiszen a válasz más
érdeklődésére is számot tarthat.

Köszönjük a segítséget!

Torma László (toros)
Ubuntu tag



További információk a(z) ubuntu-hu levelezőlistáról