pyvec / pyvec/naucse.python.cz

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

オープン
#667 コメント 3 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

beginners-course content
主要言語
言語のデータがありません
スター
335
フォーク
119
平均マージ
3時間 6分
マージ済み PR(30日)
1

説明

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

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

調査の方向性

リンク先の venv セットアップページと「Volba a nastavení editoru」章から始め、その後、長期コースで想定されている内容を確認するため、より広い「Příprava」セクションを確認してください。ワークショップ固有の準備、Windows での venv の代替手段、エディターに関するガイダンス、セルフチェックの手順についてメンテナーと明確にし、改訂された資料に一貫性があり、これらの点が網羅されていれば完了とします。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
python
領域
documentation
issue の種類
ドキュメント
難易度
4/5
見積もり時間
3〜5日
活発さ
停滞
明瞭さ
説明が足りない
初心者へのやさしさ
25/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。