pyvec / pyvec/naucse.python.cz

Podrobný tutoriál k Asteroidům

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

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

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

説明

Vojtěch Musil je programátor, který se k materiálům PyLadies dostal díky své ženě a jal se podle nich postupovat. U Asteroidů se mu ovšem pár věcí nezdálo a tak vytvořil vlastní tutoriál, který jde v mnoha oblastech více do hloubky.

Já si nejsem zcela jist, zda je tutoriál v této podobě vhodny pro PyLadies, ale chtěl bych to probrat v širším okruhu lidí. Něco málo feedbacku jsem už autorovi poskytl. Pokud o to bude zájem, tak se nějak dohodneme na předělání do markdownu nebo něcěho jiného a zařazení na naucse.

Více k motivaci od autora:

Tutorial jsem chtel vytvorit z nasledujicich duvodu:

  1. Ukazat krok za krokem, jak vytvorit nejaky vetsi program (pro zacatecniky velmi prinosne)
  2. Popsat, proc se urcite kroky v kodu delaji prave tim zpusobem (ze zdrojoveho kodu casto nevykoukas, proc ten kod nekdo pise prave tak)
  3. Mit to jako pomucku, kdyz se nekdo zasekne pri vyvoji (verim, ze toto se deje casto)
  4. Popsat fyziku hry, jak to vlastne funguje
  5. Moznost dodelat program, pokud ho nestihnou na cviceni a tim dale motivovat ucastniky kurzu

Proto si myslim, ze doplnit stavajici materialy by nemelo cenu, protoze ty maji jiny ucel nez step-by-step tutorial. Ja jsem vicemene nemel problem s nicim, pokud neberu v potaz Python jako takovy, se kterym jsem zacal prave s timto kurzem, takze si zvykam na urcite veci oproti cecku + jsem uplne nechapal zadani, proto jsem se ptal primo tebe na par detailu. Puvodne jsem to psal pro svoji zenskou a nechtel jsem, aby se moje implementace nejak vyrazne lisila od zadani. Proto to vicemene vzniklo. Vsechno ostatni se da dohledat v dokumentaci, ackoli uplne user-friendly mi nepripada, ale to je zase asi o zkusenostech v Pythonu.

Tutoriál přiložen jako ZIP Asteroids_Manual.zip

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

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

はじめの一歩

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

調査の方向性

添付された Asteroids_Manual.zip を、既存の PyLadies Asteroids の資料と併せて確認してください。まずチュートリアルがプロジェクトの対象者と目的に適合するかを判断し、その後、maintainer と希望する形式と範囲を明確にしてください。受け入れる場合に、その資料を変換して取り込むための判断と合意された方針がプロジェクトにあれば完了です。

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

評価

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

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

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