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

Abierto
#667 3 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
25/100
Tipo de issue
Documentación
Claridad
Necesita aclaración
Estado de actividad
Estancado
Stack tecnológico
python

Línea de trabajo

Comienza con la página enlazada sobre la configuración de venv y el capítulo «Volba a nastavení editoru»; después, revisa la sección más amplia «Příprava» para conocer los supuestos del curso largo. Aclara con los maintainers la preparación específica del workshop, las alternativas a venv en Windows, las indicaciones sobre el editor y los pasos de autocomprobación; se considerará terminado cuando el material revisado sea coherente y cubra estos puntos.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

beginners-course content

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".
Lenguaje dominante
Sin datos de lenguaje
Estrellas
335
Forks
119
Merge medio
3 h 6 min
PR fusionados (30 d)
1

Guía de contribución

No hay ninguna guía de contribución indexada para este repositorio

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de pyvec/naucse.python.cz

Todos los issues de pyvec/naucse.python.cz

Issues similares

Más issues de Documentation

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.