Navigation doesn't keep track of your position in the hierarchy
I maintainer di solito rispondono entro 1 giorno
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 5/5
- Tempo stimato
- Più di una settimana
- Idoneità per principianti
- 25/100
- Tipo di issue
- Funzionalità
- Chiarezza
- Da chiarire
- Stato di attività
- Ferma
- Ambito
- documentation
Direzione di ricerca
L'issue non indica file, test o punti di ingresso da esaminare. Inizia individuando l'implementazione della navigazione della documentazione e confrontando gli approcci di sidebar e breadcrumb; il lavoro è completato quando gli utenti possono spostarsi da una pagina profondamente annidata alle sezioni più ampie che la contengono, anche su dispositivi mobili.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
Observations
I click on concepts then flakes then "why should i enable flakes" from the home page. I open the sidebar on mobile. I expect to be able to navigate up in the hierarchy somehow.
Problem
Currently if you're in a specific section in the docs, you can't easily go up in the logical hierarchy to a more general section.
I had a related beef with not being able to choose Nix reference manual versions by deleting URL components which I probably filed somewhere else also.
Approaches
The way mdbook seems to do it, you can open the sidebar and the current page is highlighted. Similarly in okular while viewing pdfs. This requires a sidebar that shows every section though, and might be a bit far into paper metaphor (e.g. what order things appear in is a very book thing ported onto to a hypertext system).
Another thing we could do is breadcrumbs in the top of the page somewhere like docs.python.org (though most of the time I would consider that site a counterexample of usability). Evidently Sphinx supports it.
Willing to help?
Perhaps.
Priorities
Add 👍 to issues you find important.
- Lingua principale
- Nix
- Stelle
- 4k
- Fork
- 343
- Merge medio
- 20h 27m
- PR unite (30g)
- 10
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Nessun modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di NixOS/nix.dev
-
site
Difficoltà 1/5 1-3 ore Idoneità per principianti 72/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 76/100
NixOS/nix.dev#1224 · 1 commento · 1 reazione ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 3/5 1-2 giorni Idoneità per principianti 55/100
I maintainer di solito rispondono entro 1 giorno
-
FAQ (idea draft)Apertasite
Difficoltà 3/5 1-2 giorni Idoneità per principianti 35/100
I maintainer di solito rispondono entro 1 giorno
-
site
Difficoltà 5/5 Più di una settimana Idoneità per principianti 38/100
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di NixOS/nix.dev
Issue simili
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 62/100
-
documentation good first issue
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 72/100
I maintainer di solito rispondono entro 1 giorno
-
documentation
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100
EchoTools/nevr-runtime#2042 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 1/5 1-3 ore Idoneità per principianti 78/100
QuantConnect/Documentation#2838 ·
I maintainer di solito rispondono entro 1 giorno
-
untriaged
Difficoltà 2/5 Mezza giornata Idoneità per principianti 80/100
opensearch-project/documentation-website#13449 ·
I maintainer di solito rispondono entro 1 giorno