Introduce notation and clarify prerequsites
Los mantenedores suelen responder en 1 día
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 4/5
- Tiempo estimado
- 3-5 días
- Aptitud para principiantes
- 38/100
- Tipo de issue
- Documentación
- Claridad
- Bastante claro
- Estado de actividad
- Estancado
- Stack tecnológico
- git
- Área
- documentation
Línea de trabajo
Empieza revisando los tutoriales y el issue enlazado sobre la notación de diff, #984, para identificar dónde los principiantes se encuentran por primera vez con la notación o necesitan contexto de Git. Se considera terminado cuando el material relevante del tutorial introduce la notación y especifica claramente los prerrequisitos útiles, con enlaces a recursos adecuados.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Observations
Beginners seem to struggle with some basics that may be obvious to software developers but aren't to everyone else. One example is the diff notation: https://github.com/NixOS/nix.dev/issues/984
Problem
We're still not clear enough on what's actually required to make good use of the tutorials.
Approaches
-
Introduce notation explicitly, before first use or in an index (with links to relevant resources)
-
Note where appropriate that experience with Git is helpful (and link to useful materials)
Currently the tutorials have no actual Git interaction, but Git is everywhere.
Willing to help?
As always
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
-
Cleanup SetupPosiblemente ocupada @AlexanderKaran la tomó hoy. Abiertodocumentation enhancement
Dificultad 2/5 1-3 horas Aptitud para principiantes 64/100
e18e/framework-tracker#769 ·
Los mantenedores suelen responder en 1 día
-
fix(docker): correct stale --db-path comments in fetch/git Dockerfiles and clarify git READMEAbiertobug v2
Dificultad 1/5 Menos de una hora Aptitud para principiantes 88/100
modelcontextprotocol/servers#5483 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 84/100
simonw/sqlite-utils#928 ·
Los mantenedores suelen responder en 3 días
-
agentic-workflows automation repo-assist
Dificultad 1/5 Menos de una hora Aptitud para principiantes 85/100
shanselman/winget-tui#483 ·
Los mantenedores suelen responder en 2 días
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 90/100
griptape-ai/griptape-nodes-library-elevenlabs#30 ·
Los mantenedores suelen responder en 1 día