Rozdělení stránky formuláře na UI\Forms a Forms\Form

Při psaní tématu zjišťuji, že trochu podobná věc už se řešila před 5 měsíci (a možná vznikla kvůli stejnému zmatení, o kterém budu psát).

Tématem je tedy stránka Formuláře.

Problém míchání UI\Form a Forms\Form

Článek píše o 2 rozlišných přístupech a třídách. Nette\Application\UI\Form pro MVC využití a Nette\Forms\Form pro externí využití Nette. Tento způsob se snaží o zachování max. množství informací pro oboje, což často znepříjemňuje čtení, když chci znát jen jedno. Zejména nováčka nezajímá nějaké MVC a dává to klacky pod nohy, pokud existuje jednodušší třída Nette\Forms\Form, s kterou to vyřeším raz dva.

Ten, kdo článek nečte po páté nemůže tušit, že musí dávát pozor (a sám empiricky/dohledáváním zjišťovat), co je ještě jednoduché a co už je MVC. Jiné je zpracování formuláře v Nette\Forms\Form a jiné v MVC. Je to v celku jasná věc, která by lidem v začátku pomohla, ale blbě se to do dokumentace dopisuje, protože už nyní je dost nepřehledná.

Vykreslovací guláš
Vykreslování je podobně hloupě rozdělené (zřejmě kvůli strachu z nafukování již tak velké stránky).

• https://doc.nette.org/cs/forms
• https://dev.nette.org/cs/formulare/vykreslovani

K renderování formulářů toho lze napsat hodně, zároveň to ale často není potřeba vidět na společné stránce s metodami třídy Form, proto bych to vyčlenil jako podstránku, kde by byl umožněn přehlednější a příjemnější rozvoj tohoto tématu

Návrh

Jelikož mne to pálí, zbastlím svou ideu na dev, kterou sem pak hodím ke konstruktivní kritice a doladění, případně co a jak. Navíc někdo nemusí hned pochopit, co je mým úmyslem, tak bude jasnější, když ji prezentuji ve své čistotě. Hrubá představa je prioritně psát o Nette\Application\UI\Form s úvodní informací o odlišnostech a odkaz na Nette\Forms\Form verzi, kde by byly popsané příslušné přístupy.

Jistě bychom se mohli sáhodlouze bavit a vybublat do prázdna, jako vlákno uvedené na začátku článku, ale to nechci.

Prosím tedy o jasné, stručné a konstruktivně zdůvodněné reakce!

Díky :)