Stránka Základní operace s formuláři

Jan Tvrdík napsal(a):

Jsem sám, kdo to tak dělá?

I já to dělám, zejména kvůli non-public metodám a vlastnostem presenteru.

Doporučoval bych tedy opačný postup – používat callbacky a zmínit anonymní funkce.

Já bych to postavil na stejnou úroveň. Prostě buď to nebo to.

Editoval Majkl578 (17. 6. 2010 15:44)

na1k napsal(a):

Taky jsem spíš pro callbacky (teď mě napadá – jak je to s Nette\Callback?), a to kvůli přehlednosti kódu, která by měla být v dokumentaci co nejlepší.
A anonymní funkce zmínit v tipu.

Dokumentace je psána primárně pro PHP 5.3 a Nette 1.0-alpha, takže bych volil přímo ukázku, ne jen tip.
Nette\Callback nabízí globální funkci callback. Zatím asi nezdokumentováno.

Ad spousta diskuze o továrničkách je to imho zbytečné továrničky budou mít v dokumentaci vlastní „stránku“. (Je toho totiž docela hodně co o nich říct)

Správně by se měly továrničky vysvětlovat v kapitole „komponenty“ a zde na to jen odkazovat. Vzhledem k tomu, že ale není pořádně na co odkazovat jsem tam ty kecy o továrničkách zatím nechal a vyhodí se až časem.

pokusil jsem se tuto stránku zpřehlednit a zjednodušit tak na to mrkněte

Tak jsem se vám na to kouknul a krom nějakých oprav chybných kódů, jednoho chybného i/y a tak jsem udělal pár řekněme „kontroverzních“ změn:

• Méně jsem nedoporučil anonymní funkce (protože je s oblibou používám a nepřehledné mi to rozhodně nepřijde).
• $that = $this jsem změnil zpět na $presenter = $this. Přijde mi tak zřejmější význam proměnné, než nějaké do $tamto přiřaď $toto.
• Názvy callbacků jsem udělal ve Visual Studio like stylu a dal tam poznámku, že ať si každý vymyslí jaký systém chce, pokud bude systémový.

Nette\Callback jsem vám tam nechal, přestože ho nechápu. Jistě bych se nezlobil, kdyby ho někdo zdokumentoval a v té dokumentaci by vysvětlil, k čemu to je.

Tak nenavrhuj, ale realizuj. Určitě je fakt, že spousta tipů se dá přeformulovat do normálního textu.

Takhle nějak bych si to tvoření dokumentace představoval. Řekne se, co se napíše, někdo to sesmolí a pak se nad tím pár schopných lidiček zamyslí a pošteluje to, aby to vypadalo lépe. :)

Jan Tvrdík napsal(a):

Majkl578: Proč jsi zrušil final u presenterů? Dokumentace by měla navádět k Best practise (via https://phpfashion.com/…enters-views).

Ten článek jsem nikdy nečetl a osobně ani presentery nedával final. A v dokumentaci mi to přislo zbytečné, protože tam mluvíme o neurčitých kusech kódu (stejně tak jsem změnil BasePresenter na Nette\Application\Presenter).

Honza Marek napsal(a):
…

Vrták chtěl Closury vyhodit úplně, ale to jsem mu nedovolil. :D Jinak s těmi úpravami nemám problém.

webmaster se podle všeho vrátil z GeeksOnTheRoad a rovnou odjel na dovolenou do chorvatska… :-(

Editoval vrtak-cz (19. 6. 2010 2:42)