kılavuz: KabaForge kullanım kılavuzu (EN + TR, 10 bölüm)

2026-07-24 09:33:01 +03:00
commit dfebe8a742
11 changed files with 1096 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.