Introduce notation and clarify prerequsites
I maintainer di solito rispondono entro 1 giorno
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 4/5
- Tempo stimato
- 3-5 giorni
- Idoneità per principianti
- 38/100
- Tipo di issue
- Documentazione
- Chiarezza
- Abbastanza chiara
- Stato di attività
- Ferma
- Stack tecnologico
- git
- Ambito
- documentation
Direzione di ricerca
Inizia esaminando i tutorial e l’issue collegata sulla notazione diff, #984, per individuare dove i principianti incontrano per la prima volta la notazione o hanno bisogno di contesto su Git. Il lavoro è completato quando il materiale pertinente del tutorial introduce la notazione e indica chiaramente i prerequisiti utili, con link a risorse appropriate.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
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.
- 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