kılavuz: 09-branches-and-pull-requests/readme.md

2026-07-24 06:31:35 +00:00
parent dc68e41245
commit 9a8ff2cb74
1 changed files with 107 additions and 0 deletions
@@ -0,0 +1,107 @@
 # 🇬🇧 09 — Branches and pull requests
 A branch is a safe copy of the project where you can work without disturbing `main`. A pull request is the request to bring that work back.
 ## When you need a branch
 - The change is big enough that half-finished work would break things.
 - Somebody should look at it before it goes live.
 - You want to try an idea and be able to throw it away.
 For a typo in a document, committing straight to `main` is fine.
 ## Creating a branch in the browser
 While committing (chapter 03), choose **Create a new branch for this commit and start a pull request**, name the branch, and commit. Good names describe the work:
 ```
 docs/vlan-notes
 fix/wrong-gateway
 feature/report-export
 ```
 ## Opening a pull request
 1. Go to **Pull Requests → New Pull Request**.
 2. Pick the source branch (yours) and the target (`main`).
 3. Title = what the change does. Description = why, plus anything reviewers should check.
 4. Press **Create Pull Request**.
 ## Review
 - Reviewers comment on individual lines from the **Files Changed** tab.
 - Push more commits to the same branch — the pull request updates itself.
 - When it is approved, press **Merge Pull Request**, then delete the branch.
 ## Merge conflicts
 If `main` changed the same lines you did, KabaForge asks you to resolve it. From your computer:
 ```bash
 git switch my-branch
 git fetch origin
 git merge origin/main
 # open the marked files, keep the correct lines
 git add .
 git commit
 git push
 ```
 ## Protecting `main`
 **Settings → Branches → Add rule**: require pull requests and approvals before anything reaches `main`. Recommended as soon as more than one person works in the repository.
 ---
 # 🇹🇷 09 — Dallar ve değişiklik istekleri
 Dal, `main`'i rahatsız etmeden çalışabileceğiniz güvenli bir kopyadır. Değişiklik isteği (pull request) ise o çalışmayı geri getirme talebidir.
 ## Ne zaman dal gerekir
 - Değişiklik, yarım hâliyle işleri bozacak kadar büyükse.
 - Yayına girmeden önce birinin bakması gerekiyorsa.
 - Bir fikri deneyip gerekirse çöpe atabilmek istiyorsanız.
 Bir belgedeki yazım hatası için doğrudan `main`'e işlemek yeterlidir.
 ## Tarayıcıda dal oluşturma
 İşleme sırasında (bölüm 03) **Bu işleme için yeni bir dal oluşturun ve bir değişiklik isteği başlatın** seçeneğini seçin, dala ad verip işleyin. İyi adlar işi anlatır:
 ```
 docs/vlan-notlari
 fix/yanlis-gateway
 feature/rapor-disa-aktarim
 ```
 ## Değişiklik isteği açma
 1. **Değişiklik İstekleri → Yeni Değişiklik İsteği**.
 2. Kaynak dalı (sizinki) ve hedefi (`main`) seçin.
 3. Başlık = değişikliğin ne yaptığı. Açıklama = nedeni ve incelemecilerin bakması gerekenler.
 4. **Değişiklik İsteği Oluştur**'a basın.
 ## İnceleme
 - İncelemeciler **Değişen Dosyalar** sekmesinden tek tek satırlara yorum yazar.
 - Aynı dala yeni işlemeler gönderin — istek kendini günceller.
 - Onaylanınca **Birleştir**'e basın, ardından dalı silin.
 ## Birleştirme çakışmaları
 `main` sizinle aynı satırları değiştirdiyse KabaForge çözmenizi ister. Bilgisayarınızdan:
 ```bash
 git switch dalim
 git fetch origin
 git merge origin/main
 # işaretlenen dosyaları açın, doğru satırları bırakın
 git add .
 git commit
 git push
 ```
 ## `main` dalını koruma
 **Ayarlar → Dallar → Kural ekle**: `main`'e bir şey girmeden önce değişiklik isteği ve onay şartı koyun. Depoda birden fazla kişi çalışır çalışmaz önerilir.