Kur kontribuon në një projekt Open Source në platforma si GitHub, përdoren disa koncepte bazë:
- Fork
- Commit
- Pull Request (PR)
Këto janë hapat standard për të kontribuar në çdo projekt.
1. Çfarë është Fork
Fork është një kopje e një projekti ekzistues në llogarinë tënde.
Pse përdoret?
- Nuk ke akses direkt për të ndryshuar projektin origjinal
- Punon në kopjen tënde pa rrezikuar projektin kryesor
Pra:
Fork = kopje personale e projektit
2. Çfarë është Commit
Commit është ruajtja e ndryshimeve që ke bërë në kod.
Çdo commit ka:
- Ndryshimet që ke bërë
- Një mesazh përshkrues
Shembull:
git commit -m “Fix bug në login”
Pra:
Commit = ruajtje e një ndryshimi
3. Çfarë është Pull Request (PR)
Pull Request është një kërkesë për të bashkuar ndryshimet e tua me projektin origjinal.
Me PR:
- Dërgon ndryshimet te maintainer-at
- Ata e kontrollojnë kodin
- E pranojnë ose kërkojnë ndryshime
Pra:
Pull Request = kërkesë për bashkim të kodit
Si lidhen këto mes tyre
Procesi standard është:
- Fork projektin
- E shkarkon në kompjuter (clone)
- Bën ndryshime
- Bën commit
- E dërgon në GitHub (push)
- Krijon Pull Request
Shembull praktik
Imagjino që dëshiron të rregullosh një gabim në një projekt:
Hapat:
- Klikon Fork në GitHub
- Shkarkon projektin:
git clone https://github.com/username/projekti
- Bën ndryshimet në kod
- Shton ndryshimet:
git add .
- Bën commit:
git commit -m “Rregullim i gabimit në formë”
- E dërgon:
git push
- Hap Pull Request në GitHub
Këshilla praktike
- Shkruaj mesazhe të qarta për commit
- Bëj ndryshime të vogla (më lehtë pranohen)
- Lexo CONTRIBUTING.md para se të fillosh
- Respekto rregullat e projektit
Gabime të zakonshme
- Të dërgosh shumë ndryshime në një PR
- Mesazhe commit pa kuptim (“update”, “fix”)
- Të mos testosh kodin para PR
Përfundim
Këto tre koncepte janë baza e çdo kontributi në Open Source:
- Fork → krijon kopjen tënde
- Commit → ruan punën tënde
- Pull Request → ndan punën me projektin
Nëse i kupton këto, ke bërë hapin më të madh drejt Open Source.