General documentation about practice exercises
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 5/5
- Tempo stimato
- Più di una settimana
- Idoneità per principianti
- 25/100
- Tipo di issue
- Documentazione
- Chiarezza
- Da chiarire
- Stato di attività
- Ferma
- Ambito
- documentation
Direzione di ricerca
Inizia dalla discussione collegata nell’issue, inclusi la pull request 2149 e la relativa review, quindi esamina la documentazione esistente sugli esercizi di apprendimento citata nella descrizione. Definisci l’ambito delle indicazioni sugli esercizi pratici per maintainer e studenti; il lavoro è completato quando i criteri pertinenti, la motivazione e il workflow degli studenti sono documentati e facilmente individuabili.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
It came up in https://github.com/exercism/problem-specifications/pull/2149#pullrequestreview-1178116799 and other conversations that we are currently missing documentation/explanation/rationale on practice exercises in general, e.g.
What makes a good practice exercise? It what ways should they challenge the student? Do we want to leave some ambiguity in the descriptions to make it more like real life or should descriptions always be as clear as possible? What are the criteria for adding a new exercise to problem spec or a track?
The above applies to the maintainer side. Additionally, we might also miss more documentation/tutorials around how to deal with practice exercises as a student (e.g. TDD, you need to select the concept to use on your own, potentially try different ones, etc.).
Sidenote: For learning exercises there is a bit more written down I think but there might be more needed as well.
- Lingua principale
- Nessun dato sulla lingua
- Stelle
- 52
- Fork
- 98
- Merge medio
- 9m
- PR unite (30g)
- 4
Preparare l'ambiente
Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.
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 exercism/docs
-
Difficoltà 5/5 Più di una settimana Idoneità per principianti 20/100
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 42/100
-
Difficoltà 5/5 Più di una settimana Idoneità per principianti 20/100
-
Difficoltà 3/5 1-2 giorni Idoneità per principianti 35/100
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 35/100
Tutte le issue di exercism/docs
Issue simili
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
UNIVERSE-HPC/course-material#283 ·
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 72/100
supadata-ai/mcp#27 ·
-
area:space-accuracy good first issue track:data
Difficoltà 2/5 1-3 ore Idoneità per principianti 85/100
Sara-Managed-Projects/space-radar#904 ·
I maintainer di solito rispondono entro 1 giorno
-
Changelog missig 5.7.6Aperta
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100