pyvec / pyvec/naucse.python.cz

Podrobný tutoriál k Asteroidům

Aperta
#165 7 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

content
Lingua principale
Nessun dato sulla lingua
Stelle
335
Fork
119
Merge medio
3h 6m
PR unite (30g)
1

Descrizione

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

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Direzione di ricerca

Esamina l’archivio Asteroids_Manual.zip allegato insieme ai materiali PyLadies Asteroids esistenti. Determina innanzitutto se il tutorial è adatto al pubblico e allo scopo del progetto, quindi chiarisci con i maintainer il formato e l’ambito desiderati. Il lavoro è completo quando il progetto ha preso una decisione e concordato un percorso per convertire e includere il materiale, se viene accettato.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
python
Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
5/5
Tempo stimato
Più di una settimana
Stato di attività
Ferma
Chiarezza
Da chiarire
Idoneità per principianti
25/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.