Vyhození části dokumentace šablon

Souhlasím a @**Schmutzka** bych vzkázal, že tohle se spíš hodí do vývojářské wiki.

@Jan Tvrdík: Myslím, že tohle pěkně ukazuje, že dělení dokumentace na oddělené části jako wiki/dev je matoucí.
Když si je i HosipLan plete (o mě už ani nemluvě), tak to asi znamená, že je takové dělení zbytečné.

Podle mě je dokumentace text s příklady, který vysvětluje logiku a použití. Čím víc příkladů, tím líp. Dělení na „dokumentaci“ a ostatní „ne-dokumentace“ je imho umělé. Začátečník narazí jen na to, co se na tomto webu propaguje odkazy, což znamená pouze „dokumentaci“. „Dokumentace“ nikdy neodkazuje na „ne-dokumentaci“.

Další minus „ne-dokumentace“ je její neprofesionální vzhled. Když jsem s Nette začínal, do wiki/dev jsem nakoukl a šel pryč. Vypadá, jako něčí pískoviště. Zastaralé dokumenty bez na první pohled patrného smyslu.

V podstatě není nic špatného na tom mít část dokumentace, která to bere šupem (aka vaše pojetí dokumentace), ale pak by měla mít jakousi zrcadlovou „podrobnou dokumentaci v příkladech“, která popisuje skutečně všechno. Pořád mám dojem, že začátečník musí pročíst celé fórum, aby mohl programovat něco víc, než jen „blog za 10 minut“.

Poznámka: Tím nechci současnou dokumentaci úplně sepsout. Je fakt dobrá, jen prostě není úplná.