1. tēma: Ievads un darba vide. 5. stunda: Kodu koplietošana un dokumentēšana.

Tavs šīs stundas izaicinājums: Tu iemācīsies atpazīt dokumentācijas nozīmi programmēšanā, patstāvīgi izveidot skaidru projekta aprakstu un ievērot sadarbības etiķeti, publicējot savu darbu GitHub vietnē.

SR 2.4.9. (Kodu koplietošana), 3.1.5. (Intelektuālais īpašums un autorība)

Teorija: Kāpēc dokumentēt kodu?

README loma: Tā ir projekta "vizītkarte". Profesionālā vidē projekts bez README faila tiek uzskatīts par nepabeigtu un neuzticamu.
Autorība un etiķete: Norādot sevi kā autoru, Tu fiksē savu intelektuālo īpašumu. Skaidras instrukcijas palīdz citiem (un Tev pašam pēc laika) saprast, kā palaist programmu.
Commit ziņojumu kultūra: "Check-point" aprakstiem jābūt īsiem un jēgpilniem. Izvairies no "fix", "123" vai "update" – raksti "Pievienota spēles instrukcija".
Atvērtība: Pat privātos projektos dokumentācija palīdz uzturēt koda kvalitāti un strukturētu domāšanu.

1. uzdevums: Projekta vizītkartes izveide

Izveidot galveno informācijas failu, lai ikviens uzreiz saprastu Tava projekta mērķi.

Izpildes soļi:

VS Code atver savu mapi mana_spele.
Izveido jaunu failu: README.txt.
Pirmajā rindā ieraksti spēles nosaukumu (piem., "MEŽA PIEDZĪVOJUMS").
Zem nosaukuma pieraksti: "Šī ir mana pirmā Python spēle, kas tapusi programmēšanas kursa ietvaros."
Saglabā failu (Ctrl+S).

2. uzdevums: Instrukciju un autorības pievienošana

Sagatavot projekta aprakstu tā, lai lietotāji zinātu, kā spēli palaist un kurš to radījis.

Izpildes soļi:

Papildini README.txt ar sadaļu KĀ SPĒLĒT.
Uzskaiti prasības: Python 3.12 instalācija un komanda palaišanai: python tests.py.
Faila beigās pievieno sadaļu AUTORS un norādi savu vārdu, uzvārdu un gadu.
Pārliecinies, ka teksts ir pārskatāms un bez gramatikas kļūdām.

3. uzdevums: Dokumentācijas publicēšana GitHub

Nostiprināt darba ciklu, sinhronizējot dokumentāciju ar attālināto krātuvi.

Izpildes soļi:

Terminālī pārbaudi izmaiņas: git status.
Pievieno dokumentu: git add README.txt.
Izveido vēstures punktu: git commit -m "Pievienota projekta dokumentācija un autora dati".
Nosūti uz mākoni: git push.
Atver pārlūkā savu GitHub krātuvi un pārliecinies, ka fails ir tur un ir salasāms.

Biežākās kļūdas (un kā tās labot):

Fails neparādās GitHub: Tu, iespējams, veici commit, bet neizpildīji git push.
Nolasāmas "puzles" commit ziņojumos: Ja ziņojums ir "asdf" vai "labots", citi nezinās, ko Tu mainīji. Vienmēr raksti skaidri.
Pazaudēta autorība: Ja neesi veicis git config (3. stunda), vēsturē neparādīsies Tavs vārds.
Faila paplašinājums: Pārliecinies, ka fails ir .txt (vēlāk mācīsimies .md formātu).

Zini, kāpēc tas ir svarīgi? Labs programmētājs neraksta kodu tikai datoram; viņš raksta kodu un dokumentāciju citiem cilvēkiem. Prasme izskaidrot savu darbu ir tikpat svarīga kā prasme programmēt.

Profesionāls darba cikls terminālī

git status                         # Pārbaudām, kas mainīts
git add README.txt                 # Sagatavojam konkrēto failu
git commit -m "Pievienots README"  # Fiksējam vēsturē
git push                           # Nosūtām uz GitHub

[main 7d2e1a9] Pievienota dokumentācija
1 file changed, 12 insertions(+)
To github.com:skolens/mana_spele.git