100 PaperCuts

Project Goal

A 100 Papercuts projekt célja, hogy azonosítsa, rögzítse a jól látható, könnyen kijavítható Liferay Portál hibákat (bug). A projekt hajtóereje a szélesebb Liferay közösség, amelynek önkéntesei azonosítják, rangsorolják, elosztják és megoldják az ismert problémákat.

Projekt csapat

 

A folyamat

1. Problémák meghatározása. A közösséget mindig arra ösztönöztük, hogy olyan témákra szavazzon, melyeknek megoldását minél előbb szeretné látni. Ez lehetővé teszi a Liferay program vezetői számára, hogy a közösségi visszacsatolás alapján megfelelően rangsorolják a hibákat. A 100 Paper Cuts program esetében a szavazás még fontossabbá vált. Ugyanazt a szavazási rendszert alkalmazzuk a jól látható, könnyen javítható hibák azonosítására. A 100 Paper Cuts folyamat egy olyan időszakkal kezdődik, amikor további szavazásra buzdítunk. Ha szeretne valamelyik témára szavazni, olvassa el a szavazási folyamatot.

2. Kijelölés és megoldás. Egy kéthetes időszak alatt kb. 10 témát választunk ki és oldunk meg hatásuk és a megoldásukhoz szükséges erőfeszítés alapján. Főként olyan hibákat oldunk meg, amelyek megoldásához egy fejlesztő-nap elegendő. Ezt a periódust "Közösségi Sprint" időszaknak hívjuk, és egy fix időmennyiséget jelent, amely alatt a kiválasztott kérdéseket meg kell oldani. Ha a sprint időszakon már túl vagyunk, a folyamat elölről kezdődik.

3. A haladás nyomon követése. A sprint alatt és után nyomon követhetjük a témákban történt előrelépést mindaddig, amíg a kérdés nem épül be egy vagy több Liferay kiadásba.

Problémák megoldása

A Community Contibute-ban találhatók olyan dokumentumok, amelyek leírják, hogyan lehet hozzájárulni a Liferay-hez. A 100 PC program esetében a hozzájárulás formája a hibajavítás. A program célja, hogy a hiba a Közösség által megoldott (Community Resolved) státuszba kerüljön. Amint a probléma ebbe a státuszba kerül, a Liferay munkatársai átveszik, hogy beillesszék a forráskódba. A fejlesztésről, és a Liferay-en való hibajavításról további információ található az alábbi forrásokban:

Papqercut megoldása:

1. Készítsen egy azonosítót az issues.liferay.com oldalon. Ha nem rendelkezik azonosítóval, regisztráljon (ingyenesen!).

2. Böngésszen a problémák között. Ha bármelyik esetében úgy érzi, hogy az egy papercut, függetlenül attól, hogy személy szerint akar-e rajta dolgozni, vagy sem, bejelölheti a témát az alábbi szöveg beírásával: "This issue is a backlog candidate for the 100 PaperCuts program. Please consider participating! See http://liferay.com/community/100-papercuts".

3. A tartalékos jelöltek közül válasszon ki egy problémát egy adott sprinthez.

4. Olvassa el és gondolja át a kérdést, amin dolgozni akar. Próbálja meg reprodukálni a problémát a Liferay legújabb (trunk) verzióján. Ha a trunkon nem tudja reprodukálni, és a bug egy korábbi változatra vonatkozik, próbálja meg azzal a változattal újra előállítani. Ha a korábbi változattal tudja reprodukálni, de az újabb változattal nem, akkor a hiba valószínűleg már megoldódott. Írjon egy kommentet azzal a tartalommal, hogy véleménye szerint a hiba javításra került, és ha a probléma felvetője ezzel egyetért, a Liferay kezelésbe veszi a probléma megoldását.

Ha ELŐ TUDJA ÁLLÍTANI az újabb változaton is, akkor az első teendő, hogy az alábbi sablon segítségével kommentet ír a témához: "This issue is currently being addressed in Sprint X the 100 PaperCuts program. Please see http://liferay.com/community/100-papercuts". Ez alapján a komment alapján ki tudjuk szűrni és meg tudjuk találni a papercutokat a JIRA szűrők segítségével

6. A problémát a fenti fejlesztési útmutató és eszközök segítéségével oldja meg.

7. Ha a probléma megoldásra került, készítenie kell egy patch-t (hibajavító programot) a svn diff > LPS-[ISSUE]-build-[SVN REVISION].patch. Például, a LPS-12322 on SVN revision 43533-hez egy patch készítése esetén a fájl neve LPS-12322-build-43533.patchlesz.

8. A JIRA csatolási funkció segítségével csatolja a patch-t. A patch mellé csatoljon egy kommentet, amiben elmagyarázza a javítás mibenlétét. Egyúttal kérje meg a probléma felvetőjét, hogy ellenőrizze az Ön megoldását, kérje, hogy kattintson az "Elfogadom a közreműködést" ("Accept Contribution") opcióra (lásd lent), amennyiben megfelelőnek találja a megoldást.

9. Fontos! A problémánál kattintson a "Megoldás benyújtása" ("Contribute Solution") linkre. Ezzel jelzi, hogy a problémát Ön oldotta meg és az most már a programhiba (bug) eredeti felvetőjének kezében van. Az ő feladata, hogy ellenőrizze a megoldást és rákattintson az "Accept Contribution" opcióra. Ezzel a jegy "Community Resolved" státuszba kerül, ahol a Liferay Program Management átveszi annak a jövőbeni Liferay kiadásokba való átvezetését. Ezzel az Ön szerepe véget is ért. Gratulálunk!

10. Ha a probléma eredeti benyújtója már nem aktív, és egy hét, vagy hosszabb idő elteltével sem kap választ, értesítse a csapatot és mi megkeressük a benyújtót. Amennyiben nem tudjuk elérni őt, a nevében elfogadjuk a megoldást (természetesen ellenőrzés után).

Sok szerencsét és jó vadászatot!