Skip to content

Contributing to INFO ID 2026 Website using Visual Studio Code

Axi edited this page Oct 13, 2026 · 3 revisions

Acest ghid explică pas cu pas cum poți contribui la repository-ul nostru GitHub folosind Visual Studio Code, fără să fie nevoie să folosești comenzi Git în terminal.

Începem prin a alege un task. Intram la https://github.com/infoid26/Website/issues si alegem un issue liber. La Assignees, apasam Assign yourself. Pe panoul Kanban il mutam la "In progress". Pentru primul task, luati ceva mic.

Workflow-ul este:

**Kanban:Assign Issue → Clone Repository → Create Branch → Modify Files → Commit → Publish/Sync → Pull Request → Approved → Kanban:Done **

Repository-ul proiectului este:

https://github.com/infoid26/Website

Branch-ul main este protejat, iar membrii organizației nu pot crea repository-uri noi. Repository-urile noi pot fi create doar de Owneri.


1. Ce trebuie instalat

Ai nevoie de:

  • Git
  • Visual Studio Code

2. Instalează Git

Git este sistemul de versionare folosit de GitHub și Visual Studio Code.

Download oficial:

https://git-scm.com/downloads

Pentru Windows:

https://git-scm.com/download/win

Descarcă versiunea recomandată și pornește installer-ul.

Pentru majoritatea utilizatorilor poți lăsa opțiunile implicite și continua cu:

Next → Next → Next → Install

După instalare, dacă Visual Studio Code era deja deschis, închide-l și pornește-l din nou.


3. Instalează Visual Studio Code

Download oficial:

https://code.visualstudio.com/Download

Instalează versiunea potrivită pentru sistemul tău de operare.

Pentru Windows, de regulă poți folosi installer-ul standard x64.

Visual Studio Code are suport Git integrat, deci workflow-ul normal poate fi făcut din interfața grafică:

  • Clone Repository
  • Create Branch
  • Switch Branch
  • Stage Changes
  • Commit
  • Publish Branch
  • Push
  • Pull
  • Sync Changes

Nu este necesar să folosești terminalul pentru pașii obișnuiți.


4. Clonează repository-ul

Clonarea înseamnă că descarci proiectul GitHub pe calculatorul tău.

Deschide Visual Studio Code.

Pe pagina de început ar trebui să vezi:

Clone Git Repository

Dacă nu apare:

  1. apasă iconița Source Control din bara din stânga;
  2. apasă Clone Repository.

Folosește URL-ul:

https://github.com/infoid26/Website

Alternativ, poți intra pe GitHub în repository și să apeși:

Code → HTTPS → Copy

Apoi în Visual Studio Code:

  1. apasă Clone Repository;
  2. lipește URL-ul repository-ului;
  3. apasă Enter;
  4. alege folderul unde vrei să salvezi proiectul;
  5. așteaptă terminarea clonării;
  6. când VS Code întreabă dacă vrei să deschizi repository-ul, apasă Open.

Acum ai proiectul pe calculator.


5. Branch-ul main este protejat

Branch-ul principal al proiectului este:

main

main este protejat și nu poate fi folosit direct pentru modificări.

Ca să poți trimite un Pull Request, trebuie să lucrezi într-un branch separat.

Un Pull Request compară două branch-uri:

branch-ul tău → main

De aceea nu poți lucra direct pe main și apoi să creezi Pull Request către același main.

Workflow-ul corect este:

main → Create new branch → modificări → Commit → Publish/Sync → Pull Request


6. Creează un branch nou

În partea de jos a Visual Studio Code vei vedea branch-ul curent.

De obicei va scrie:

main

Apasă pe main.

Apoi selectează:

Create new branch

Scrie un nume care descrie modificarea.

Exemple:

feature/add-favicon

feature/add-discord-button

feature/add-whatsapp-link

fix/mobile-menu

fix/footer

docs/update-readme

După creare, VS Code te va muta automat pe noul branch.

Verifică în partea de jos că nu mai scrie main, ci numele branch-ului creat.


7. Fă modificările

Acum poți modifica fișierele proiectului.

De exemplu:

index.html

orar.html

style.css

script.js

sau orice alt fișier necesar.

Salvează modificările cu:

Ctrl + S


8. Verifică fișierele modificate

Apasă iconița:

Source Control

din bara din stânga.

Vei vedea secțiunea:

Changes

Acolo apar toate fișierele modificate.

De exemplu:

M index.html

M style.css

Litera M înseamnă:

Modified

Dacă ai creat un fișier nou, acesta va apărea de asemenea în Source Control.


9. Verifică exact ce ai schimbat

Înainte de commit este recomandat să verifici modificările.

În Source Control, apasă pe un fișier modificat.

Visual Studio Code va afișa diferențele dintre:

  • versiunea veche;
  • versiunea modificată.

Astfel poți verifica exact ce urmează să trimiți.


10. Stage Changes

În Source Control, când treci cu mouse-ul peste un fișier modificat, apare simbolul:

+

Apasă + pentru fișierele pe care vrei să le incluzi în commit.

Fișierele vor fi mutate din:

Changes

în:

Staged Changes

Dacă vrei să incluzi toate modificările, poți folosi:

Stage All Changes


11. Scrie mesajul de commit

În partea de sus a secțiunii Source Control există câmpul:

Message

Scrie acolo pe scurt ce ai modificat.

Exemple bune:

Add favicon

Add WhatsApp button

Fix mobile menu

Update homepage links

Fix timetable layout

Evită mesaje precum:

update

test

stuff

changes

Mesajul trebuie să spună clar ce ai făcut.


12. Fă Commit

După ce ai scris mesajul, apasă:

Commit

Commit-ul salvează modificările tale în istoricul Git local al branch-ului.

La prima utilizare este posibil ca Visual Studio Code sau Git să îți ceară configurarea numelui și a adresei de e-mail.

Urmează instrucțiunile afișate.


13. Publish Branch

Prima dată când trimiți un branch nou către GitHub, Visual Studio Code va afișa:

Publish Branch

Apasă:

Publish Branch

Branch-ul tău va fi trimis pe GitHub.

Este posibil ca GitHub să îți ceară autentificarea în browser.

Urmează pașii afișați și autorizează Visual Studio Code.


14. Dacă mai faci modificări pe același branch

Poți continua să lucrezi pe același branch dacă modificările aparțin aceluiași task.

De exemplu, dacă branch-ul este:

feature/add-favicon

și mai corectezi ceva legat de favicon, continui pe același branch.

Workflow-ul este:

  1. modifici fișierele;
  2. deschizi Source Control;
  3. faci Stage Changes;
  4. scrii mesajul;
  5. apeși Commit;
  6. apeși Sync Changes.

15. Sync Changes

După commit, Visual Studio Code poate afișa:

Sync Changes

Apasă:

Sync Changes

Aceasta sincronizează modificările locale cu repository-ul de pe GitHub.

Commit-urile tale vor fi trimise pe GitHub.


16. Creează Pull Request

După ce branch-ul a fost publicat pe GitHub, intră pe:

https://github.com/infoid26/Website

GitHub va detecta de obicei branch-ul trimis recent și va afișa:

Compare & pull request

Apasă pe el.

Pull Request-ul este cererea prin care propui ca modificările tale să fie introduse în branch-ul principal main.


17. Verifică branch-urile din Pull Request

Trebuie să apară ceva de forma:

base: main

și:

compare: feature/numele-branchului

Exemplu:

base: main

compare: feature/add-favicon

Asta înseamnă:

modificările din feature/add-favicon vor fi propuse pentru integrare în main.


18. Titlul Pull Request-ului

Folosește un titlu clar.

Exemple:

Add favicon

Add Discord and WhatsApp links

Fix mobile navigation

Update timetable page


19. Descrierea Pull Request-ului

Descrie pe scurt ce ai modificat.

Exemplu:

Added the favicon and updated the HTML head section.

sau:

Added Discord, WhatsApp and GitHub buttons to the homepage.

Nu trebuie să fie foarte lung.

Important este să se înțeleagă ce ai făcut.


20. Creează Pull Request-ul

Apasă:

Create pull request

  • modificările tale au fost trimise pentru review;
  • este necesar sa asignezi un grup de useri sau un user pentru a fi notificat ca PR-ul asteapta feedback/approve
reviewers

21. Pull Request-ul trebuie verificat

Branch-ul main este protejat, deci modificările trebuie integrate prin Pull Request.

Un administrator sau maintainer al repository-ului va verifica:

  • ce fișiere ai modificat;
  • dacă modificările funcționează;
  • dacă nu există probleme;
  • dacă pot fi integrate în main.

După verificare, Pull Request-ul poate fi aprobat și integrat.


22. Dacă ți se cer modificări

Este posibil ca la Pull Request să primești comentarii sau cereri de modificare.

Nu crea alt Pull Request.

Deschide proiectul în Visual Studio Code.

Asigură-te că ești pe același branch.

Exemplu:

feature/add-favicon

Fă modificarea necesară.

Apoi:

  1. Source Control
  2. Stage Changes
  3. scrie mesajul de commit
  4. Commit
  5. Sync Changes

Pull Request-ul existent se va actualiza automat.

Nu trebuie să creezi alt Pull Request.


23. După ce Pull Request-ul a fost acceptat

După ce modificările tale au fost integrate în main, pentru un task nou trebuie să pornești din versiunea actualizată a branch-ului main.

În Visual Studio Code:

  1. apasă pe numele branch-ului din partea de jos;
  2. selectează main;
  3. deschide Source Control;
  4. deschide meniul ...;
  5. selectează Pull.

Astfel descarci ultima versiune a proiectului.


24. Pentru un task nou creează alt branch

După ce ai actualizat main, creează un branch nou.

Exemplu:

Task anterior:

feature/add-favicon

Task nou:

feature/add-whatsapp-link

Nu continua toate task-urile pe același branch vechi.


25. Workflow complet

Prima dată:

Install Git

↓

Install Visual Studio Code

↓

Clone Repository

↓

Open Repository

↓

Create Branch

↓

Modify Files

↓

Stage Changes

↓

Commit

↓

Publish Branch

↓

Create Pull Request

Pentru următoarele task-uri:

Switch to main

↓

Pull

↓

Create new branch

↓

Modify Files

↓

Stage Changes

↓

Commit

↓

Publish / Sync

↓

Create Pull Request


26. Reguli importante

  1. Membrii nu pot crea repository-uri noi. Repository-urile noi pot fi create doar de Owneri.
  2. Branch-ul main este protejat.
  3. Modificările nu se fac direct în main.
  4. Pentru fiecare task se creează un branch separat.
  5. Modificările ajung în main prin Pull Request.
  6. Un task = un branch.
  7. Un branch = un Pull Request.
  8. Actualizează main înainte să începi un task nou.
  9. Folosește nume clare pentru branch-uri.
  10. Folosește mesaje clare pentru commit-uri.
  11. Verifică modificările înainte de commit.
  12. Dacă primești feedback pe Pull Request, continuă să lucrezi pe același branch.
  13. Nu crea alt Pull Request pentru corecturi ale aceluiași task.

27. Exemple de nume pentru branch-uri

Pentru funcționalități noi:

feature/add-favicon

feature/add-discord-link

feature/add-whatsapp-link

feature/add-schedule-page

Pentru repararea unei probleme:

fix/mobile-menu

fix/footer-layout

fix/broken-link

Pentru documentație:

docs/update-readme

docs/update-wiki


28. Ce înseamnă termenii principali

Repository

Proiectul GitHub care conține toate fișierele și istoricul acestora.

Repository-ul nostru:

https://github.com/infoid26/Website

Clone

Descarcă repository-ul pe calculatorul tău.

Branch

O ramură separată a proiectului pe care poți lucra fără să modifici direct versiunea principală.

main

Branch-ul principal al proiectului.

La noi, main este protejat.

Commit

Salvează un set de modificări în istoricul Git.

Publish Branch

Trimite pentru prima dată branch-ul local către GitHub.

Sync Changes

Sincronizează modificările locale cu GitHub.

Pull

Descarcă ultimele modificări de pe GitHub.

Pull Request

Cerere prin care propui ca modificările din branch-ul tău să fie integrate în main.

Un Pull Request compară un branch sursă cu un branch destinație.

Exemplu:

feature/add-favicon → main

Merge

Integrarea modificărilor aprobate dintr-un branch în main.


29. Dacă ceva nu merge

Dacă apare o problemă, nu încerca să refaci proiectul de la zero.

Nu este nevoie să:

  • ștergi proiectul;
  • creezi branch-uri suplimentare fără motiv;
  • faci alt Pull Request pentru același task.

Întreabă unul dintre administratorii repository-ului.

În majoritatea cazurilor problema poate fi rezolvată fără să refaci proiectul.


Quick Reference

Pentru fiecare modificare nouă:

  1. Open repository in VS Code
  2. Switch to main
  3. Pull
  4. Create new branch
  5. Modify files
  6. Open Source Control
  7. Stage Changes
  8. Write commit message
  9. Commit
  10. Publish Branch / Sync Changes
  11. Open GitHub
  12. Create Pull Request
  13. Wait for review

INFO ID 2026 — FMI UniBuc

Repository:

https://github.com/infoid26/Website