pyvec / pyvec/naucse.python.cz

Návrh k úpravě materiálů po hadím workshopu

Aperta
#667 3 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

beginners-course content
Lingua principale
Nessun dato sulla lingua
Stelle
335
Fork
119
Merge medio
3h 6m
PR unite (30g)
1

Descrizione

Mám pár poznámek k sekci Příprava z pozice kouče na workshopu.

Obecná:
Vyzkoušeli jsme víckrát, že příkaz py -3 -m venv venv nevytvořil virtuální prostředí na Windows počítačích. Pomáhala varianta python -m venv venv nebo python3 -m venv venv. Hodily by se doplnit, ale nevím, které místo pro opravu je to správné.

Specifické:
Příprava pro (jednorázový) hadí ws je stejná jako pro (dlouhodobé) začátečnické kurzy, a proto je tam trochu "šumu", který účastnice rozptyluje - a prodlužuje první krok workshopu. Možná by stalo za to přípravu mít ve dvou variantach, druhou právě pro one-time workshopy. A konkrétně:

  1. vytváření adresářů pro každou lekci není třeba, ve složce naucse-python se vytváří pouze soubory související s hadem.

  2. doporučení VS Code se mi nezdá nejšťastnější, důvody:

  • vestavěný terminál nebyl ve vícero případech nakloněn spolupracovat s venv způsobem, jaký je popsán v materiálech, účastnici se opakovaně pokoušeli pouštět programy nejprve v VSC, pak ve vedlejším terminálu
  • okýnka s návrhy na add-ony jsou malé peklíčko
  • spousta koučů s ním neumí - zvyšení obecného zmatku, když místo Pythonu řešíme, proč se editor nějak (ne)chová.
    Myslím přeformulování této kapitoly s navedením na jednodušší editor s obarvením syntaxe, ale bez ohňostrojů, kde se VS Code ponechá jako další krok ("Až se v budoucnu porozhledneš po robustnejším editoru textu, který toho umí víc, zvaž tyto" ).
    Když se teď pročítám kapitolou Volba a nastavení editoru, přijde mi, že v podstatě říkáme, že IDE není dobré na začátek, a přesto jim doporučujeme IDE :)
  1. Do závěru Přípravy by mohl by se hodit návod na self-check, spousta lidí totiž netušila, jestli vlastně mají, nebo nemají vše. Něco hezčího ve smyslu: "A teď zavři všechna okna a zkus: otevřit příkazovou řádku, spustit a zavřit konzoli Pythonu, navigovat do své složky, aktivovat venv, spustit editor".

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Direzione di ricerca

Inizia dalla pagina collegata sulla configurazione di venv e dal capitolo «Volba a nastavení editoru», quindi esamina la sezione più ampia «Příprava» per le ipotesi relative al corso lungo. Chiarisci con i maintainer la preparazione specifica per il workshop, le alternative a venv su Windows, le indicazioni sull’editor e i passaggi di autoverifica; il lavoro è completato quando il materiale revisionato è coerente e copre questi punti.

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

Valutazione

Stack tecnologico
python
Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
4/5
Tempo stimato
3-5 giorni
Stato di attività
Ferma
Chiarezza
Da chiarire
Idoneità per principianti
25/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.