Pentru fiecare modificare / set de modificări, se creează un "branch" nou, din "master", care este branch-ul de referință. În drop-down-ul din stânga trebuie să fie selectat master, și apoi se pune numele unui branch nou (e important să nu mai existe deja același branch), și se alege "create branch: from 'master'"
D
Dacă creați un branch nou, el va fi selectat apoi automat. Dacă vă întoarceți pe github ulterior, trebuie să vă asigurați că branch-ul vostru este selectat în drop-down-ul din stânga, și dacă nu e, să-l selectați înainte să faceți modificări
Apoi, în branch-ul vostru, selectați fișierul în care veți să propuneți modificări (sau selectați Add file > Create new file din meniul din dreapta drop-down-ului pentru branch-uri). Odată deschis, aveți un buton de editare:
musai musai să vă asigurați că sunteți pe branch-ul vostru, altfel pot apărea necazuri
Faceți ce modificări credeți că sunt necesare. Ideal, seturile de modificări (un set de modificări sunt schimbările înainte de a da "commit") au sens de sine stătător sau împreună cu altele, dar nu includ într-un singur set modificări care nu țin unele de altele (putem extrage și grupa mai multe seturi de modificări împreună, dar nu putem sparge o singură modificare în mai multe).
După ce terminați un set de modificări, în josul paginii, sub fișierul text, aveți o zonă cu "Commit changes". Ideal, folosiți prima căsuță pentru a descrie măcar sumar ce modificare se face și de ce. Pentru detalii, folosiți și a doua căsuță. Notele astea sunt super utile când, în viitor, căutăm de ce au fost modificate / adăugate articole.
Dacă aveți mai multe emailuri înregistrate în github, alegeți cel de @scout.ro.
Alegeți întotdeauna prima opțiune - Commit directly in the numele-branchului-meu branch pentru ca modificările să fie grupate corect. Asigurați-vă că sunteți pe branch-ul corect. Alegeți apoi "commit".
Pentru a verifica cum s-a modificat per total branch-ul vostru față de referința din master după una sau mai multe modificări, puteți merge la Pull Requests / New Pull Request
Și aici alegeți pentru base master și pentru compare branch-ul vostru.
Implicit, veți vedea toate modificările. Puteți și creați un Pull Request. După ce-l creați (și îi dați un nume, eventual), nu mai trebuie să intrați la New Pull Request, puteți să accesați comparația din lista de la pull requests.
Din secțiunea Pull Requests, pentru oricare din pull requesturile existente, se selectează tab-ul "files", acolo unde se face comparația side-by-side
Aici, dacă mergi cu mouse-ul deasupra oricărei linii care se schimbă (fie pe versiunea veche, sau pe cea nouă), butonul de + (sau -) devine un buton care poate fi apăsat pentru a lăsa un comentariu. Comentariile se salvează cu butonul "add single comment" (și NU cu cel verde "Start a review")
