Přidat do dokumentace levý panel?
- David Grudl
- Nette Core | 8110
Klikni pro zvětšení:
Dokumentace funguje dobře i bez něj, tak nevím, jestli to není zbytečný šum. (současná podoba)
- Tomáš Votruba
- Moderator | 1114
Osobně jsem pro 0 panelů a výstižný obsah.
Je pak těžké se soustředit a správně si vybrat, když je tam tolik možností. Tím spíš když je tam někdo poprvé.
Co by to mělo přinést?
- David Grudl
- Nette Core | 8110
Je to celkem obvyklý prvek v dokumentacích, který by měl sloužit ke snažší navigaci mezi stránkami. Ale nemám v praxi nijak ověřené, jestli je fakt užitečný, nebo naopak zbytečný.
- Milo
- Nette Core | 1283
Ty jsi teď nasadil obdobu té druhé varianty? Nesedí mi na tom, že se nadpis těch souvisejích kapitol v pravém panelu mění podle tématu. Spíš by mi vyhovovalo něco statického, třeba „Související“. Aby když kouknu do pravého panelu, vždycky jsem našel tu samou položku.
Ale ještě zpět k první variantě s levým menu. Ta by mi asi vyhovovala víc. Nikdy jsem se nenaučil mít okno s dokumentací, a browserem obecně, zmenšené třeba na 1/2 monitoru, takže ho mám maximalizované vždy. Já mám tedy vlevo vždycky místa dost. Dokumentaci už moc nečtu, ale občas, když do ní zabloudím, je to během práce. Najít nějaký detail k formulářům, pak k DI a takhle skáču. A teď to je na X kliků. Jeden klik z levého menu by byl pro mě super.
- David Grudl
- Nette Core | 8110
Jo, zkouším s tím experimentovat a přidal jsem nahoru do pravého panelu odkaz na další kapitoly tématu.
S tím levým panelem mám jeden docela problém. Jde o otázku, zda Nette dokumentovat jako monolit, nebo jako jednotlivé balíky (cca). V případě monolitu je společné menu asi ok, v případě balíků by tam být nemělo, protože věci jako Latte, Tester, Tracy jsou zcela nezávislé a měly by se jim věnovat samostatné stránky.
- Pavel Janda
- Člen | 977
První varianta naprosto boží!!
Lidé, kteří si prochází dokumentaci, se rádi rychle prokliknou na související kapitoly. Klidně se tam dá zmínit, že jde o jiné balíky. Třeba jinou barvou apod.
Editoval Pavel Janda (4. 9. 2017 11:51)
- Felix
- Nette Core | 1186
Zajimavy napad je zobrazit/skryt ten levy panel z 1. prikladu. Kdyz by to nekoho obtezovalo, tak by si to mohl pohodlne skryt. Levy navigacni panel je super vec, usetri radu prokliku. Jedina nevyhoda je, jak uz jsi zminoval, ze by to mohlo nekoho plest, ze se jednotlive balicky nedaji pouzivat zvlast. Bohuzel me nenapada jak to elegantne vyresit.
Dobra prace mimochodem ;-)
- dez1nd
- Člen | 7
David Grudl napsal(a):
Klikni pro zvětšení:
Dokumentace funguje dobře i bez něj, tak nevím, jestli to není zbytečný šum. (současná podoba)
Jsem pro obě. :)
- karelu
- Člen | 14
David Grudl napsal(a):
Klikni pro zvětšení:
Dokumentace funguje dobře i bez něj, tak nevím, jestli to není zbytečný šum. (současná podoba)
Davide,
ta navigace vlevo je naprosto super, jen bych nenechával v tom levém sloupci
nahoře tolik místa.
Díky
Karel
- igor.pocta
- Člen | 100
Ahoj,
nějak postrádám odkaz do Download ( https://nette.org/cs/packages , tady v modré hlavičce je).
Přes prvotní tutoriál jsem se dostal sem – https://doc.nette.org/cs/quickstart – kde jsem už našel příkaz pro composer .
