Navigation doesn't keep track of your position in the hierarchy
Los mantenedores suelen responder en 1 día
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Aptitud para principiantes
- 25/100
- Tipo de issue
- Nueva funcionalidad
- Claridad
- Necesita aclaración
- Estado de actividad
- Estancado
- Área
- documentation
Línea de trabajo
El issue no indica archivos, pruebas ni puntos de entrada que inspeccionar. Empieza por localizar la implementación de la navegación de la documentación y comparar los enfoques de sidebar y breadcrumb; se considera terminado cuando los usuarios pueden pasar de una página profundamente anidada a sus secciones más generales, también en dispositivos móviles.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
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.
- Lenguaje dominante
- Nix
- Estrellas
- 4k
- Forks
- 343
- Merge medio
- 20 h 27 min
- PR fusionados (30 d)
- 10
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Sin plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de NixOS/nix.dev
-
site
Dificultad 1/5 1-3 horas Aptitud para principiantes 72/100
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 76/100
NixOS/nix.dev#1224 · 1 comentario · 1 reacción ·
Los mantenedores suelen responder en 1 día
-
Dificultad 3/5 1-2 días Aptitud para principiantes 55/100
Los mantenedores suelen responder en 1 día
-
FAQ (idea draft)Abiertosite
Dificultad 3/5 1-2 días Aptitud para principiantes 35/100
Los mantenedores suelen responder en 1 día
-
site
Dificultad 5/5 Más de una semana Aptitud para principiantes 38/100
Los mantenedores suelen responder en 1 día
Todos los issues de NixOS/nix.dev
Issues similares
-
documentation Feedback Response Revision
Dificultad 2/5 1-3 horas Aptitud para principiantes 66/100
Aeolus-Software/RealmForge#241 ·
Los mantenedores suelen responder en 1 día
-
crate: spate-kafka documentation priority: medium
Dificultad 1/5 Menos de una hora Aptitud para principiantes 88/100
Los mantenedores suelen responder en 1 día
-
good first issue
Dificultad 1/5 Menos de una hora Aptitud para principiantes 87/100
btclib-org/btclib-node#2260 ·
Los mantenedores suelen responder en 1 día
-
content triage
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
Los mantenedores suelen responder en 1 día
-
🔍 External Broken Links ReportAbiertobug documentation
Dificultad 1/5 Menos de una hora Aptitud para principiantes 68/100
eclipse-edc/eclipse-edc.github.io#250 ·
Los mantenedores suelen responder en 1 día