Repository navigation
Contributing to INFO ID 2026 Website using Visual Studio Code
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
maineste protejat, iar membrii organizației nu pot crea repository-uri noi. Repository-urile noi pot fi create doar de Owneri.
Ai nevoie de:
- Git
- Visual Studio Code
Git este sistemul de versionare folosit de GitHub și Visual Studio Code.
Download oficial:
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.
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.
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:
- apasă iconița Source Control din bara din stânga;
- 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:
- apasă Clone Repository;
- lipește URL-ul repository-ului;
- apasă Enter;
- alege folderul unde vrei să salvezi proiectul;
- așteaptă terminarea clonării;
- când VS Code întreabă dacă vrei să deschizi repository-ul, apasă Open.
Acum ai proiectul pe calculator.
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
Î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.
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
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.
Î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.
Î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
Î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.
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.
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.
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:
- modifici fișierele;
- deschizi Source Control;
- faci Stage Changes;
- scrii mesajul;
- apeși Commit;
- apeși 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.
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.
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.
Folosește un titlu clar.
Exemple:
Add favicon
Add Discord and WhatsApp links
Fix mobile navigation
Update timetable page
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.
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
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.
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:
- Source Control
- Stage Changes
- scrie mesajul de commit
- Commit
- Sync Changes
Pull Request-ul existent se va actualiza automat.
Nu trebuie să creezi alt Pull Request.
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:
- apasă pe numele branch-ului din partea de jos;
- selectează
main; - deschide Source Control;
- deschide meniul
...; - selectează Pull.
Astfel descarci ultima versiune a proiectului.
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.
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
- Membrii nu pot crea repository-uri noi. Repository-urile noi pot fi create doar de Owneri.
- Branch-ul
maineste protejat. - Modificările nu se fac direct în
main. - Pentru fiecare task se creează un branch separat.
- Modificările ajung în
mainprin Pull Request. - Un task = un branch.
- Un branch = un Pull Request.
- Actualizează
mainînainte să începi un task nou. - Folosește nume clare pentru branch-uri.
- Folosește mesaje clare pentru commit-uri.
- Verifică modificările înainte de commit.
- Dacă primești feedback pe Pull Request, continuă să lucrezi pe același branch.
- Nu crea alt Pull Request pentru corecturi ale aceluiași task.
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
Proiectul GitHub care conține toate fișierele și istoricul acestora.
Repository-ul nostru:
https://github.com/infoid26/Website
Descarcă repository-ul pe calculatorul tău.
O ramură separată a proiectului pe care poți lucra fără să modifici direct versiunea principală.
Branch-ul principal al proiectului.
La noi, main este protejat.
Salvează un set de modificări în istoricul Git.
Trimite pentru prima dată branch-ul local către GitHub.
Sincronizează modificările locale cu GitHub.
Descarcă ultimele modificări de pe GitHub.
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
Integrarea modificărilor aprobate dintr-un branch în main.
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.
Pentru fiecare modificare nouă:
- Open repository in VS Code
- Switch to
main - Pull
- Create new branch
- Modify files
- Open Source Control
- Stage Changes
- Write commit message
- Commit
- Publish Branch / Sync Changes
- Open GitHub
- Create Pull Request
- Wait for review
INFO ID 2026 — FMI UniBuc
Repository: