pyvec / pyvec/naucse.python.cz

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

Đang mở
#667 3 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

beginners-course content
Ngôn ngữ chính
Không có dữ liệu ngôn ngữ
Star
335
Fork
119
Merge trung bình
3 giờ 6 phút
Pull request đã merge (30 ngày)
1

Mô tả

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".

Hướng dẫn đóng góp

Chưa lập chỉ mục được hướng dẫn đóng góp cho kho mã nguồn này

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Hướng nghiên cứu

Bắt đầu với trang thiết lập venv được liên kết và chương “Volba a nastavení editoru”, sau đó xem lại phần “Příprava” rộng hơn để nắm các giả định của khóa học dài. Trao đổi với các maintainer để làm rõ phần chuẩn bị dành riêng cho workshop, các lựa chọn thay thế venv trên Windows, hướng dẫn về trình soạn thảo và các bước tự kiểm tra; được coi là hoàn tất khi tài liệu đã chỉnh sửa nhất quán và bao quát các điểm này.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Công nghệ
python
Lĩnh vực
documentation
Loại issue
Tài liệu
Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức độ hoạt động
Đình trệ
Độ rõ ràng
Cần làm rõ
Mức phù hợp với người mới
25/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.