Hledám spolupracovníka pro psaní dokumentace

LM napsal(a):

Našel jsem pár chybek třeba v https://doc.nette.org/…n/components mezi třídou a metodou měla zůstat :: , třeba je tam: Nette\Component\lookup($type).

Opraveno.

Ještě k těm prostorům, nemělo by např místo: class Application extends Nette\Object být class Application extends \Nette\Object, protože se nezměnil jen separátor… teď se třídy dohledávají relativně k deklaraci namespace.

A je to bug nebo feature? Zatím jsem odpověď nenašel.

romansklenar napsal(a):

A naopak zase u Nette\Security::Permission chybí ten skvělý oddělovač jmenných prostorů.

opraveno

Honza M. napsal(a):

Jestli jsou nutné nevím, ale dělá se to třeba v časopisech.

Prosím odrážky bez čárek i středníků. Pokud odrážku tvoří věta (začíná velkým písmenem), tak s tečkou na konci.

phx napsal(a):

Typograficky (možná to je i norma) je to správbně s čárkou (středník je asi také povolen). Já to chápu tak, že kdyby se náhodou ony odrážky stratili, tak by daný text měl být stále čitelný díky čárce.

Díky za objasnění :) dává to smysl… ale na tom webu to na mě působí tak nějak zvláštně

Ještě jsem si všiml jednoho bugu po změně oddělovače jmenných prostorů v dokumentaci, a to že se změnily bloky kódu /--code na ; a u těchto bloků se jakoby zdvojnásobí řádkování při normálním prohlížení.

Je to sice šíleně kacířská myšlenka, ale… nebylo by lepší opustit jmenné prostory a vrátit se k prefixu N? ;)

Jen to ne, i když zvolený separátor nebyla moc dobrá volba, tak ostatní věci jako autoloading vs interní třídy snad už dopadnou dobře.

kravco napsal(a):

Inak, nebolo by rozumné úvod Nette\Application\Route, ktorý je viac-menej všeobecný, presunúť do (zatiaľ prázdneho) Routování?

Určitě ano, dělení dokumentace striktně podle tříd není šťastné.

Ahoj, je fajn, že jsi se pustil do chybějících dílů Quick Startu, a díky ti za to=) Zběžně jsem pročetl osmou kapitolu a měl bych dvě poznámky:

1. BasePresenter je lepší definovat jako abstraktní třídu, jinak by mohl být zavolatelný z prohlížeče.
2. Mohl by jsi se více rozepsat o stránkování a řazení? Při prvním pohledu do kódu není hned patrné, jak tyto dvě věci fungují (u stránkování se můžeš třeba zmínit o zajímavě řešeném zobrazení odkazů při velkém počtu stránek).

Se šablonou se nepleteš, v presenteru Default už pohled table není, takže šablona je navíc.

Přidal jsem poslední chybějící kousky nezdokumentovaných tříd do dokumentace. Enjoy ;)

Přečti, oladěnkuj a uprav pokud najdeš chyby ;) Rád se přiučím z vlastních chyb, protože je dost možné že tam nějaké budou, moc praxe nemám zatím s formulářema, takže tam by moh být kámen úrazu.

Paráda, si borec =)

Jo, hlasím se k autorství. Jen to, prosím, někdo zase prolétněte, jestli tam nejsou do očí bijící nesmysly. Případně opravte i ty do očí nebijící.

Davide, možná by stálo za to upravit ty drobné chyby v aplikacích ke stažení v quick startu. Chceš poslat upravené verze, abys to uploadnul? Jsou tam drobnosti, ale mohou být pro nováčka matoucí.

Davide, možná by stálo za to upravit ty drobné chyby v aplikacích ke stažení v quick startu. Chceš poslat upravené verze, abys to uploadnul? Jsou tam drobnosti, ale mohou být pro nováčka matoucí.

Jasně pošli. V neděli to zapracuju.

Prošel jsem si znovu všechny příklady z quick startu a teď už jsou opravené. Buď jsi reagoval na tuhle diskusi a opravil jsi to, nebo jsem blázen a ty drobnosti, co tam byly, tam vlastně nebyly.

David Grudl napsal(a):

Jan Tvrdík napsal(a): Část dokumentace je psána pro PHP 5.3 a část pro PHP 5.2.

Vzhledem k tomu, že oddělovačem jmenných prostorů v PHP 5.3 bude zpětné lomítko (a zítra třeba otazník, nevím), tak sjednocení dokumentace bych zatím nechal plavat.

Aktuální statut?