carpentries-incubator / carpentries-incubator/python-intermediate-development

Common Issues, Fixes & Tips is not very accessible.

Aperta
#490 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub
Lingua principale
TeX
Stelle
63
Fork
77
Merge medio
20h 8m
PR unite (30g)
3

Descrizione

Possibly relating to #470: The issues and fixes are a bit obscure thanks to being hidden away.
They are referred to where relevant, but e.g. [here](https://carpentries-incubator.github.io/python-intermediate-development/12-virtual-environments.html#making-sure-you-can-invoke-python) it's at the end of a wordy sentence.

It could potentially be foregrounded more by having the Prerequisite just be the "What you need to be able to do", followed by another large "Common Issues" callout that says (more concisely) "If [problem], check the Common Fixes page" and links to it. Shifting the description of the fix to the fixes section would save enough space that it wouldn't take any extra.

Guida per i contributori

Apri la guida per i contributori

Direzione di ricerca

Inizia con la sezione collegata "Making sure you can invoke Python" e individua i riferimenti esistenti alle pagine Common Issues e Common Fixes. Esamina come vengono presentate le indicazioni sui prerequisiti e sui problemi, quindi rendi più evidenti i problemi comuni con link concisi; il lavoro è completato quando gli studenti possono trovare le soluzioni senza dover analizzare una frase prolissa.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
python
Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
2/5
Tempo stimato
1-3 ore
Stato di attività
Ferma
Chiarezza
Abbastanza chiara
Idoneità per principianti
45/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.