Kur dhe si duhet të rishkruani historikun e Git?

Question

Accepted Answer

Git ju lejon të **rishkruani historikun** — duke ndryshuar, ribazuar, ngjeshur ose hequr commit-e — për të pastruar commit-et ose për të rregulluar problemet. Është i fuqishëm por duhet bërë me kujdes: rishkrimi i historikut **të ndarë** shkakton probleme serioze, kështu që rregullat rreth tij janë kritike. ## Mënyrat për rishkruimin e historikut ```text git commit --amend → modify the most recent commit (message or content) git rebase -i → squash, reword, reorder, edit, drop commits (interactive) git rebase → replay commits onto another base (linear history) git reset → move the branch pointer (discard/uncommit) git filter-repo → rewrite MANY commits (remove a file/secret from all history) → All of these change commit HASHES (rewriting = creating new, different commits). ``` ## Rregulli i artë ```text ⚠️ NEVER rewrite history that has been PUSHED/SHARED (that others may have): → rewriting changes commit hashes → your history DIVERGES from collaborators' → they'll have the old commits; pulls create duplicates/conflicts; chaos ensues → forces everyone to painfully reconcile → a serious disruption ✓ Rewrite ONLY local, unpushed commits (cleanup before sharing). ✗ On shared branches → use REVERT (a new undoing commit) instead, which is safe. ``` ## Përdorimet legjitimë të rishkrimi (lokal) ```text ✓ Clean up messy WIP commits before opening a PR (squash, reword) → clean history ✓ Fix a mistake in the last commit (amend) before pushing ✓ Keep a feature branch linear/up-to-date with main (rebase) before sharing ✓ Remove a SECRET accidentally committed (filter-repo) — though if it was PUSHED, the secret must be ROTATED (it's already exposed; rewriting alone isn't enough) ``` ## Nëse duhet rishkruani historikun e ndarë (rrallë) ```text → COORDINATE with the whole team (everyone stops, re-syncs) → Force-push carefully: git push --force-with-lease (safer than --force — checks first) → Everyone must reset/re-clone to the rewritten history → Do this only when truly necessary (e.g. purging a leaked secret) and with agreement. ``` ## Pse ka rëndësi Kuptuarja e kohës dhe se si rishkruani historikun e Git është njohuri e rëndësishme e nivelit të lartë sepse rishkrimi i historikut është **i fuqishëm por i rrezikshëm**, dhe kuptimi i rregullave — veçanërisht rreth historikut të ndarë — parandalon probleme serioze ndërsa lejon pastrimin legjitim. Dija e **mënyrave për rishkrimi** (amend për commit-in e fundit, interactive rebase për ngjeshjen/ndryshimin e fjalëve/rirenditjen, rebase për historikun linear, reset, filter-repo për ndryshimet në shkallë të madhe) dhe se ato të gjitha **ndryshojnë hash-et e commit-eve** (duke krijuar commit-e të rinj) është themeli. Më kritike, kuptimi i **rregullit të artë — asnjëherë mos rishkruani historikun e ndarë/të shtyrë** — është thelbësor sepse rishkrimi ndryshon hash-et, duke shkaktuar që historiku juaj të devijojë nga kolegëve (të cilët ende kanë commit-et e vjetër), duke çuar në duplikate, konflikt dhe pajtim të dhimbshëm; rishkrimi i historikut të ndarë është një shqetësim serioz që ky rregull parandalon, me **revert** (një commit i sigurt i ri i ndotjes) duke qenë qasja e saktë për degët e ndara në vend të kësaj. Kuptuarja e **përdorimeve legjitimë lokale** (pastrimi i commit-eve WIP para një PR, ndryshimi i gabimeve para shtyrjes, ribazimi për të qëndruar linear para ndarjes — të gjitha në commit-e lokal, të nëpushuar) sqaron kur rishkrimi është i përshtatshëm dhe i vlefshëm. Një nuancë kritike e sigurisë: nëse **një sekret u commit-ua dhe u shtya**, rishkrimi i historikut për ta hequr atë nuk mjafton — sekreti është tashmë i zbuluar dhe duhet **rotua** (një pikë e rëndësishme e sigurisë në botën reale). Dija se si të **trajtohen rishkrimet e rrallë të nevojshme të historikut të ndarë** (koordinimi i ekipit, `--force-with-lease` në vend të `--force`, të gjithë duke ri-sinkronizuar) pasqyron gjykim të pjekur. Meqenëse rishkrimi i historikut është i fuqishëm por shkakton probleme serioze kur përdoret keq në historikun e ndarë, dhe meqenëse kuptimi i rregullit të artë, përdorimet legjitimë dhe praktikat e sigurta është thelbësor për ta përdorur atë në mënyrë përgjegjëse, kuptimi i kohës dhe se si rishkruani historikun e Git është njohuri e rëndësishme e nivelit të lartë — një temë ku kuptimi i rregullave të sigurisë (veçanërisht asnjëherë mos rishkruani historikun e ndarë) parandalon katastrofa reale të bashkëpunimit, duke pasqyruar gjykim-in e pritur për rolet e larta të punës me Git në ekipe.