pyvec / pyvec/naucse.python.cz
Návrh k úpravě materiálů po hadím workshopu
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- Keine Sprachdaten
- Sterne
- 335
- Forks
- 119
- Ø Merge
- 3 Std. 6 Min.
- Gemergte PRs (30 T.)
- 1
Beschreibung
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ě:
-
vytváření adresářů pro každou lekci není třeba, ve složce
naucse-pythonse vytváří pouze soubory související s hadem. -
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 :)
- 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".
Beitragsleitfaden
Für dieses Repository ist kein Beitragsleitfaden indexiert
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Öffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Beginne mit der verlinkten Seite zur Einrichtung von venv und dem Kapitel „Volba a nastavení editoru“ und prüfe anschließend den umfassenderen Abschnitt „Příprava“ im Hinblick auf die Annahmen des langen Kurses. Kläre mit den Maintainer:innen die gewünschte workshopspezifische Vorbereitung, venv-Alternativen unter Windows, Hinweise zum Editor und Schritte zur Selbstprüfung; als abgeschlossen gilt die Aufgabe, wenn das überarbeitete Material konsistent ist und diese Punkte abdeckt.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- python
- Bereich
- documentation
- Issue-Typ
- Dokumentation
- Schwierigkeit
- 4/5
- Geschätzter Aufwand
- 3-5 Tage
- Aktivitätsstatus
- Veraltet
- Klarheit
- Muss geklärt werden
- Anfängerfreundlichkeit
- 25/100