Ohm, szerintem te felreerted az API dokumentacio fogalmat.
Vessuk meg az alapokat annak, amit most mondani fogok. Ti irtatok egy keretrendszert. Ebben a keretrendszerben webalkalmazasokat lehet osszerakni, kulonfeleket, kicsiket, nagyokat, jokat, rosszakat. Ezeket - valoszinusitem - nem lehet tisztan kattintos modszerrel osszerakni, szinte biztos, hogy valamennyit fejleszteni kell hozza. Akar csak azt, hogy a bal felso sarokban valtogassa a logo helyen megjeleno kepet egy adott forrasbol, akar azt, hogy a twitter feedemet integralja bele az oldalon latott tartalomba, valami egyedi szinte biztos lesz egy webalkalmazasban, amire ti meg csak nem is gondoltatok almotokban sem.
Hogy egy ilyen webes keretrendszer bovitheto, fejlesztheto legyen, es ezaltal nepszerusegre tegyen szert, elsodleges feltetele, hogy legyen jol dokumentalt. Mivel a fejleszteshez ismerni kell a kodbazis lehetosegeit (milyen package-k vannak, milyen osztalyokkal, ezen belul milyen metodusok hivhatok (milyen parameterezessel), milyen hookok vannak, hol lehet a generalt tartalmat testreszabni rendereles elott, hol utana), szoval ezeket mind-mind dokumentalni kell ahhoz, hogy egyaltalan szamitani lehessen arra, hogy valakit is erdekelni fog egy webalkalmazas keretrendszer. A Drupal - noha o magat egy kattintas altal testreszabhato keretrendszernek aposztrofalja - igen reszletekbe meno es boseges API dokumentaciot bocsat felhasznaloi rendelkezesere, hogy ha esetleg megsem bizonyulnanak elegsegesnek az oaltala nyujtott szolgaltatasok, es valami miatt tobbre, masra vagyna az egyszeru felhasznalo, ezt minel konyebben elerhesse ugy, hogy ir egy plug-int. A plug-in egy olyan modul, mely kiboviti a meglevo rendszer tudasat ugy, hogy az alkalmas legyen egy adott feladat elvegzesere is.
Szoval, en valami olyasmire gondoltam API dokumentacio tekinteteben, amin egy egyszeri fejleszto, aki valamilyen modon fel szeretne hasznalni ezt a webes keretrendszert, el tud indulni.
--
Ki oda vagyik, hol szall a galamb, elszalasztja a kincset itt alant. | Gentoo Portal