better basic how to commit

docs/workshop/2_basics.md

@@ -19,7 +19,7 @@ $ git help config
 De ha csak egy gyors áttekintésre van szükséged:
 
 ```
-$ git config -h
+\$ git config -h
 usage: git config [<options>]
 
 Config file location
@@ -33,6 +33,7 @@ Config file location
 Action
 --get get value: name [value-regex]
 ...
+
 ```
 
 ### Repository
@@ -42,23 +43,24 @@ A Git repository egy olyan mappa, mely Git verziókezelés alatt
 Például az a mappa, ahol van egy .git mappa, az egy git repo.
 
 ```
-$ ls -al
+\$ ls -al
 total 20
 drwxrwxr-x 4 rlacko rlacko 4096 okt 8 12:59 .
 drwxrwxr-x 3 rlacko rlacko 4096 okt 7 12:04 ..
 drwxrwxr-x 5 rlacko rlacko 4096 okt 7 12:46 docs
 drwxrwxr-x 8 rlacko rlacko 4096 okt 8 16:39 .git
 -rw-r--r-- 1 rlacko rlacko 17 okt 7 12:09 README.md
+
 ```
 
-Mielőtt még nekilátnánk a távolli repository leszedésnek,
-csinálunk sajátot és onnan fogunk tovább haladni.
+Csináljunk egy sajátot!
 
 Hozzunk létre egy tetszőleges projekt mappát és lépjünk bele
 
 ```
 $ mkdir projektem
 $ cd projektem
+
 ```
 
 Nézzük meg, hogy mi a helyzet a git-el ezzel a mappában.  
@@ -67,33 +69,43 @@ Ez a parancs a jelenlegi git repo-nkról képes
 információkat kiírni.
 
 ```
-$ git status
+\$ git status
 fatal: not a git repository (or any of the parent directories): .git
+
 ```
 
-Ez igaz, ugyanis teljesen üres a mappa.
-`ls -al` -el tudod ellenőrizni
+Teljesen üres a mappa, még nincs verzió kontroll alatt.
+`ls -al` -el tudjuk is ellenőrizni.
 
 Tegyük verziókontroll alá a `git init` paranccsal.
+Ez beállítja nekünk a `master` branchet és más alap dolgokat.
+A branch-ről még később beszélek, de azt jegyezzük meg addig,
+hogy ide kerülnek a mentéspontjaink egymás után sorban, mint
+egy fa ága.
+
+<div style="text-align:center"><img src="workshop/img/basic-branching.png" alt="Git branch" /></div>
 
 ```
-$ git init .
+\$ git init .
 Initialized empty Git repository in .../projektem/.git/
+
 ```
 
 Ha megnézzük, mostmár van egy .git mappánk
 
 ```
-$ ls -al
+\$ ls -al
 total 12
 drwxrwxr-x 3 rlacko rlacko 4096 okt 8 16:52 .
 drwxrwxr-x 12 rlacko rlacko 4096 okt 8 16:49 ..
 drwxrwxr-x 7 rlacko rlacko 4096 okt 8 16:52 .git
+
 ```
 
 Ebben van minden adatunk a git repo-val kapcsolatban.
-Gyakorlatilag ha bármely projektből kivesszük ezt a mappát,
-akkor teljes egészében visszaállítható belőle minden fájl.
+Gyakorlatilag mikor egy távoli git repo-t leszedünk, akkor
+ezt a mappát kapjuk meg. Ebből ezután a git alkalmazásunk
+előállítja nekünk a master ág legutóbbi mentéspontját.
 
 #### Változtatások mentése
 
@@ -116,35 +128,35 @@ Nézzük meg ezen az ábrán és egy példa projekten keresztül:
 Mi a jelenlegi helyzet a repo-ban, miután inicializáltuk?
 
 ```
-$ git status
-...
+\$ git status
+On branch master
 No commits yet
 nothing to commit (create/copy files and use "git add" to track)
 ```
 
 Láthatjuk, hogy még nincsenek mentéspontjaink és nincs mit
-elmentenünk.
+elmentenünk és egyben a git próbál segíteni, hogy hogyan
+tudunk stagelni valamit.
+Ezt több helyen is megfigyelhetjük a git-ben.
+Próbál segíteni ahol csak tud, minél kényelmesebbé téve
+a munkánkat.
 
-```
-$ git status
-On branch master
-...
-```
-
-A branch-ről később részletesebben beszélek, de a lényeg
-egyenlőre, hogy ez az a a dolog, ahol a mentéspontokat
-sorban egymás után feltudjuk venni.
-
-Vegyünk fel egy új fájlt:
+Vegyünk fel egy új fájlt.
 
 ```
 echo 'alma' > gyumolcskosar
 ```
 
-Újra megvizsgálva a status-t:
+_Itt az `echo` egy olyan parancs volt, mely kiírta nekünk a
+terminálra azt, hogy "alma", de átirányítottuk egy fájlba
+a `>` operátorral és mivel nem létezett a fájl, azt létre is
+hozta._
+
+Újra megvizsgálva a status-t, látni fogjuk, hogy megjelent, de
+még nincs verziókontroll alatt.
 
 ```
-$ git status
+\$ git status
 ...
 Untracked files:
 (use "git add <file>..." to include in what will be committed)
@@ -153,18 +165,20 @@ Untracked files:
 nothing added to commit but untracked files present (use "git add" to track)
 ```
 
-A fájlunk még nincs git-el követve, ahogy az ábrán is
-láthatjuk.  
-`git add <fájl>` segítségével adjuk hozzá a repo-hoz.
+Ahhoz, hogy git alá helyezzük, a `git add <fájl>` parancsot
+fogjuk kiadni.
+_Ezek a parancsok mind képesek rá, hogy
+Unix-os módon több fájlra is kiadhatóak legyenek.
+Például a `<fájl>` lehet `*.jpg`amivel minden .jpg fájlt kijelölünk a jelenlegi mappában"_
 
 ```
-$ git add gyumolcskosar
+\$ git add gyumolcskosar
 ```
 
-Ezt követően
+Ezután megjelenik, mint új fájl a git adatbázisában.
 
 ```
-$ git status
+\$ git status
 ...
 Changes to be committed:
 (use "git rm --cached <file>..." to unstage)
@@ -175,12 +189,10 @@ A fájlunk átkerült staged módba és ezt akár mostmár el is
 tudjuk menteni.
 A mentéshez a `git commit` parancsot tudjuk
 használni.
-`$ git commit`
-Kiadva megnyilik a beállított szövegszerkesztőnk és némi
+`$ git commit`-ot kiadva megnyilik a beállított szövegszerkesztőnk és némi
 információ a leendő mentéspontról.
 
 ```
-
 # Please enter the commit message for your changes. Lines starting
 # with '#' will be ignored, and an empty message aborts the commit.
 #
@@ -193,29 +205,29 @@ információ a leendő mentéspontról.
 ```
 
 Láthatjuk amit a `git status` parancs írna ki és pár extra
-infót.
+segítséget a git-től.
 A # -el kezdődő sorok kommentek, ezek nem fognak a commit
 üzenetbe belekerülni.
 Írjuk be az első sorba, hogy `Készítettem egy gyümölcskosarat`,
 majd mentsük el a fájlt és zárjuk be a szövegszerkesztőt.
 
 ```
-$ git commit
+\$ git commit
 [master (root-commit) c45abc3] Készítettem egy gyümölcskosarat
 1 file changed, 1 insertion(+)
 create mode 100644 gyumolcskosar
 ```
 
 A git mikor érzékelte, hogy bezártuk a fájlt, akkor abból
-kiolvasta a sorokat és hozzáadta a mentéspontunkhoz, mint
-üzenet.
-Ezt láthatjuk is visszajelzésben.  
+kiolvasta a sorokat, ignorálva a #-el kezdődőket és hozzáadta
+a mentéspontunkhoz, mint üzenet.
+Ezt láthatjuk is a visszajelzésben.
 Továbbá megjelent pár további hasznos információ is.
 
 Ismételten nézzük meg mi a helyzet a reponkban:
 
 ```
-$ git status
+\$ git status
 On branch master
 nothing to commit, working tree clean
 ```
@@ -225,7 +237,7 @@ azt is írja, hogy még semmin nem változtattunk, nem tudunk
 mit elmenteni.
 
 Nézzük meg a további két állapotot is amiben lehet egy fájl.
-Írjuk bele a gyumolcskosar fájlba, hogy `korte`:
+Írjuk bele a gyumolcskosar fájlba, hogy `korte`
 
 ```gyumolcskosar
 alma
@@ -251,10 +263,14 @@ parancsnak áttudunk adni úgynevezett kapcsolókat.
 Például `git commit -m <message>`.
 Ez annyit spórol meg nekünk, hogy nem kell szövegszerkesztőt
 megnyitnia a git-nek mikor új commit-ot készítünk,
-hanem közvetlen megadhatjuk az üzenetet, **m**esage-et
-
-Ne felejtsük el először staged módba rakni a fájlt,
-különben nem történik mentés.
+hanem átraktuk a parancsot olyan módba,
+hogy várjon egy szöveget, mint mentéshez kapcsolódó üzenet.
+Általában logikusak az egy betűs rövidítések:  
+`-m: message, -a: all`, de tudunk hosszabb verziókat is
+használni, mint `--message, --all`.
+
+> Ne felejtsük el először stagelni a mentendő fájljaink egy
+> `git add <fájl>` parancs kiadásával.
 
 ```
 $ git add gyumolcskosar