Kérvény
A JoomlaWikiBÓL
Tartalomjegyzék |
Miért van szükség a kérvényekre?
A kérvény (angolul: white paper) többé-kevésbé hivatalos "funkcióigénylés". A fejlesztési folyamaton történő változtatás ötlete húzódik meg mögötte.
Először is tervezett.
Amikor elfogadunk egy kérvényt, akkor mindenki tudja, hogy mit akarunk elérni, és világos mérföldkő van, amit el lehet érni. Ezzel a szemléletmóddal a fejlesztési munkacsoport hatékonyabban tud kommunikálni a többi munkacsoporttal (például a dokumentációs munkacsoporttal), még a folyamat elején, mint inkább a végén.
Másodszor, ezt a mechanizmust a közösség irányítja.
Ez egyszerűen azt jelenti, hogy a következő kiadásba történő hozzájárulások a közösség bármely tagjától érkezhet, nem csak a fejlesztési munkacsoport tagjaitól. Ezt azért tesszük így, hogy elkerüljük a közbeékelődő kiadásokat, és megtudjuk azt is, hogy mit óhajt a közösségünk. A Joomla! egy fejlesztőcsoport munkájának eredménye. Fontos, hogy kihasználjuk e csoport tehetségét. Ugyanolyan fontos viszont a közösségünk tagjainak, a több millió weblaptulajdonosnak a véleménye is. Az olyan nyitott és átlátható folyamat, mint ez, több ember számára teszi lehetővé, hogy hangot adjon véleményének és ötleteinek.
Ki adhat be kérvényt?
Bárki nyújthat be kérvényt. Nem kell hozzá programozónak lenni, nincs szükség programozott megoldásra hozzá.
A kérvényeknek mindamellett meg kell határozniuk egy megvalósítható célt, és felhasználási eseteket, indokokat kell bemutatniuk, hogy ez egy jó ötlet. Nem mondhatod csak azt, hogy "Jobb hozzáférésvezérlést (ACL) szeretnék", vagy "Több felhasználói funkciót akarunk". Meg kell pontosan fogalmaznod, hogy mire gondolsz, és mit akarsz a Joomlában. A fenti példákból kiindulva akarhatsz részletesebben tagolt, egy bizonyos módon használható ACL-t; vagy "a szolgáltatási feltételek elfogadása" lehetőséget szeretnél regisztráláskor...satöbbi.
A kérvény leginkább a funkcionális követelményeket tartalmazó dokumentumhoz hasonlítható. A közös munkát is támogatjuk, ha egy csoport ugyanazon a kérvényen kíván dolgozni. Saját magad is dolgozhatsz viszont egy kérvényen, ha egy mások által megtekintett téma másik irányba terelődik. A korlátozás mindössze annyi, hogy pontosan ugyanazt teheted, ha valaki más már dolgozik rajta. Ilyen esetekben a két kérvényt benyújtó szerzőket megkérjük, hogy együtt folytassák a témát.
Irányelvek a kérvény összeállításához
A kérvénynek legalább a következőket kell tartalmaznia:
- Az általad megoldani kívánt probléma vagy funkcióigény hátterének összegzése ('miért' van rá szükség).
- A funkcionális követelmények áttekintése, vagy egyszerűen az elérendő célok ('mit' kell tenni).
- Gondolatok arról, hogy a javaslatod milyen hatással van a változáskezelésre (hatással van-e a lefelé kompatibilitásra, megváltoztatja-e oly módon a kezelőfelületet, hogy betanításra van-e szükség, stb.)
Ezeknek a tételeknek nem kell technikai jellegűeknek lenniük a természetüknél fogva. Felhasználói szemszögből, a felhasználó nyelvén megfogalmazva ismertethetik a problémákat, feltételezve, hogy elegendő információt tartalmaznak a fejlesztési munkacsoport számára, mely alapján meg tudják írni a műszaki kiegészítést, amennyiben elfogadják a kérvényt. Ha viszont megvan a képességed hozzá, akkor az alábbi kiegészítéseket szívesen fogadjuk:
- A változáskezelési problémák részletes értékelése
- A meglévő architektúrára gyakorolt hatás áttekintése
- Az API vagy a felhasználói kezelőfelület elemeinek funkcionális áttekintése (a 'hogyan')
- Bármilyen függőség, amivel az ajánlat rendelkezik. Például hivatkozhat egy másik elfogadandó kérvényre, mely olyan változást mozdít elő, melyre szükséged van. Ez további függvénytárakat is tartalmazhat, melyeket bele kell tenni a keretrendszerbe.
- A tervezendő körvonal mérföldkövekkel a továbbításhoz. "Nagymértékű" változások esetén figyelembe kell venned az elérendő lépéseket. A 6 havi fejlesztő munkát igénylő kérvényeket nem fogadjuk el. Ha viszont a kérvényben lépésekre osztod fel, mely három vagy négy verzión keresztül előfordulhat, akkor az előnyös lehet.
A fejlesztési munkacsoport tagjaitól csak akkor lehet elvárni, hogy foglalkozzanak ezekkel a további követelményekkel, ha a Te tapasztalatod alapján lehetséges.
A kérvények benyújtása
A kérvények beküldésére egy speciális alfórumban van lehetőség: http://forum.joomla.org/index.php/board,500.0.html. Ez mindenki számára nyilvános. Vannak alfórumai az "Elfogadott", a "Véleményezés alatt" és a "Visszautasított" kérvények számára, melyekbe a véleményezés során áthelyezésre kerülnek.
A kérvényt témaként kell indítani. A szerző(k)nek röviden vázolniuk kell, hogy mi van a témanyitóban, de onnantól a kérvény tényleges tartalma bárhol lehet, feltételezve, hogy nyilvánosan hozzáférhető. Példaként említhetjük a Google dokumentumokat, a wikioldalakat, egy weblap cikkét, a letölthető PDF fájlokat, vagy magát a téma szövegét. Az adathordozó egyáltalán nem számít, a lényeg, hogy a kézirat nyilvánosan megtekinthető legyen. A legegyszerűbb, ha a mester szöveget az eredeti témában őrzöd, és változtatsz rajta, amint kaptál visszajelzést.
A közösség tagjai aztán hozzászólhatnak az őket érdeklő kérvényekhez. A fórum moderált, mert a tapasztalat megtanított arra, hogy nem minden visszajelzés építő. Ezzel a szemléletmóddal mindenki számára lehetővé tesszük, hogy megossza az ötletét, és hozzászóljon. és esély van arra, hogy jónéhány "Ó, hát én nem is gondoltam erre" problémát elhessegessünk. Az emberek esetleg egy új funkció ötletét nagyszerűnek találhatják, de a felhasználók véleménye teljesen más irányba viheti el a megvalósítását. A szerzőket arra biztatjuk, hogy önmaguk moderálják a témájukat, de ha kritikává, vagy eredménytelen vitává fajul a dolog, akkor kérhetik a moderátorok segítségét.
A két egyforma kérvényt beküldőket arra kérjük, hogy egyesítsék a meglévő témákat, hacsak nincs jó okuk rá (mint megvizsgálni ugyanazt a szemléletet egy másik szemszögből, és más célokat kitűzni).
Ez alkalommal a szavazás nem engedélyezett, ugyanis azt szeretnénk, hogy a névtelen szavazás helyett nyílt vélemények legyenek.
Különleges kivételezés a kis változtatásokkal
A tagság részéről felmerülő olyan kis problémák különleges kivételben részesülnek, melyek túl jelentéktelenek ahhoz, hogy teljes kérvényt kelljen írni a témáról. Az ilyen esetek számára lesz egy kiemelt téma, melyekbe beküldhetők a kis problémák. A moderátorok figyelik ezt a témát, és a több munkát igénylő problémák esetén teljes kérvény beadását fogják kezdeményezni.
Ezt a témát az áttekintés során lezárjuk, pusztán csak azért, hogy segítsen a feldolgozás logisztikájában.
Tervezés
A kérvények benyújtása folyamatosan történik. Bárki nyújthat be, és bármikor dolgozhat rajta. Habár a záró dátumokat meg fogjuk adni, amikorra a kérvényeknek el kell készülniük, ha a következő kiadásban meg akarjuk valósítani. Ezeket a dátumokat a fórumban, egy kiemelt témában fogjuk közölni.
A szerzőknek meg kell jelölniük, hogy a kérvényük véleményezésre kész, és a záró dátum után áthelyezésre kerülnek a "Véleményezés alatt" alfórumba.
A fejlesztési munkacsoport a kérvények elfogadását két menetből álló folyamatban hajtja végre.
Első menet
A fejlesztési csoport minden tagja kiválasztja a tíz kedvenc kérvényét, és egytől tízig értékeli őket (az 1 a legjobb). Ezeket az értékeléseket összegyűjtjük és értékeljük.
A csoport tagjainak bölcsen kell dönteniük, és figyelembe kell venniük a lefelé kompatibilitási nehézségeket (akár felhasználói, oktatói, megvalósítói vagy fejlesztői nézőpontból), a közösség érdeklődését, s hogy érzik, mi lenne a legjobb a Joomla! következő kiadása számára. Az alacsony vagy nulla hozzájárulású kérvényeket, irányelvként, nem rangsoroljuk magasra. A csoporttagoknak, az ő értékelésükben, egyensúlyozniuk kell a közösség akarata és a szükséges munka között.
Második menet
Az első menetből szerzett eredményekből a tíz legkevesebb összesített pontszámú kérvényt választják ki részletes elemzésre. A fejlesztési munkacsoport aztán a kérvények alapján megírja a műszaki specifikációkat (néhányukkal kis vagy semmi munka lehet, másikakkal sok), mely a ráfordítandó munkát is tartalmazza. A csoport aztán felméri, hogy ezt a munkamennyiséget bele tudja-e tenni a következő verzióba. Ha nem, akkor a kérvényt egy kissé hátrébb sorolják. Ha igen, akkor a következő öt értékelt kérvényt (irányelvként) vizsgálják meg.
A javaslatokat hátrébb sorolhatják, több verzión keresztül, lépésekben beütemezhetik, vagy kissé módosíthatják annak alapján, hogy a közösség hozzájárulásából mely eltérő nézőpontok érhetnek el legjobb illesztés eredményt. A kérvény eredeti pontjának azonban még meg kell maradnia. Egy ötlet átvétele és átalakítása egy kívánt, de eltérő végeredménybe nem kerül elfogadásra, végtére is megsérti maga a konzultációs folyamat épségét és hitelességét.
Az elfogadott kérvényeket az Accepted (Elfogadottak) alfórumba helyezik át. Eközben a kérvényeket szabványos formátumban átteszik a dokumentációs wikibe. Amint elégedett a csoport a specifikációkkal, és felállították a mérföldköveket a következő verzióra, hivatalosan közzétette őket, akkor elkezdődik a következő verzió fejlesztési szakasza.
A többi kérvény az Under Review (Véleményezés alatt) fórumból visszakerül a kérvények főfórumába, ha úgy vélik, hogy nem tudják vagy nem akarják megvalósítani, amely esetben a Denied (Elutasítottak) fórumba kerülnek. Egy idő múlva ki fogják dolgozni az el nem fogadható dolgokra való irányelveket, és a kérvények beküldéséhez mintákat is rendelkezésre fognak bocsájtani.
