Přidat do dokumentace levý panel?

před 3 měsíci

David Grudl
founder | 6705
+
+41
-

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)

před 3 měsíci

Tomáš Votruba
Moderator | 1130
+
-24
-

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?

před 3 měsíci

David Grudl
founder | 6705
+
+10
-

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ý.

před 3 měsíci

David Grudl
founder | 6705
+
+5
-

Ještě mě napadlo něco takového:

před 3 měsíci

Zuben45
Člen | 267
+
+1
-

Obě možnosti se mi líbí, ale přiklonil bych se spíše k té druhé, popřípadě k tlačítku, které by zobrazilo/skrylo levý panel :)

před 3 měsíci

Milo
Moderator | 1031
+
+3
-

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.

před 3 měsíci

David Grudl
founder | 6705
+
0
-

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.

před 3 měsíci

Milo
Moderator | 1031
+
+4
-

Za mě určitě dokumentovat jako samostatné balíky a tím myslím obsahově. Ale levé menu bych chápal jako rozcestník, tam by mi sloučení vůbec nevadilo. Ušetří to klikání.

před 3 měsíci

Spectator
Člen | 42
+
0
-

Levé menu je podle mne dobré, ale asi by mi přišlo lepší, kdyby byly kapitoly sbalené a byly rozbalovací. Takhle je to dlouhé až kamsi a tím, že není vždy část vidět, se stává zakrytá část nepoužitelná.

před 3 měsíci

Pavel Janda
Člen | 730
+
+2
-

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. 11:51)

před 3 měsíci

Felix
Člen | 749
+
+2
-

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 ;-)

před 2 měsíci

pekelnik
Člen | 468
+
+1
-

Navigace mi v dokumentaci vždycky chyběla :)

před 2 měsíci

dez1nd
Člen | 6
+
0
-

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ě. :)

před 2 měsíci

karelu
Člen | 12
+
+1
-

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

před 2 měsíci

igor.pocta
Člen | 96
+
+1
-

Ahoj,

nějak postrádám odkaz do Download ( https://nette.org/cs/download , tady v modré hlavičce je).

Přes prvotní tutoriál jsem se dostal sem – https://doc.nette.org/…ting-started – kde jsem už našel příkaz pro composer .

před 2 měsíci

Václav Pávek
Člen | 33
+
0
-

jsem pro variantu 1