Skip to content

chore: repo cilası — yapısal hijyen, README profesyonelleştirme, SEO, anatomi tamamlama#1

Merged
halilibrahimd27 merged 10 commits into
mainfrom
chore/repo-polish
Jun 28, 2026
Merged

chore: repo cilası — yapısal hijyen, README profesyonelleştirme, SEO, anatomi tamamlama#1
halilibrahimd27 merged 10 commits into
mainfrom
chore/repo-polish

Conversation

@halilibrahimd27

@halilibrahimd27 halilibrahimd27 commented Jun 27, 2026

Copy link
Copy Markdown
Owner

Özet

DevOps Notebook'un tam denetim + kalite pası. Denetim: AUDIT.md · Tam değişiklik dökümü: CHANGES-SUMMARY.md.

İlke: Hiçbir teknik içerik silinmedi. Taşımalar git mv (geçmiş korundu), bölmeler byte-eksiksiz (assertion ile doğrulandı). Yalnızca README pazarlama bloğu kaldırıldı (açıkça raporlandı → CHANGES-SUMMARY.md §4).

Fazlar

  • Faz 1 — Yapısal hijyen: Dağınık saha-notu klasörleri (System/Network/Ansible/Terraform/kubectl) → tek 21-Field-Notes/ bölümü; tümü kebab-case + geçerli markdown. build-docs.sh/mkdocs.yml senkron.
  • Faz 2 — Dev dosya bölme: RoadMap/Advanced RoadMap.md (8568 satır/217KB) → 14 faz sayfası + linkli index.
  • Faz 3 — Anatomi: 7 anti-pattern tablosu + 12 production checklist (CLAUDE.md sesinde, uydurma yok; ultracode workflow + adversarial doğrulama).
  • Faz 4 — Placeholder hijyeni: hardcoded zayıf parolalar → <PLACEHOLDER>, action full-semver pin → @<VERSION>, Network RFC-1918 disclaimer.
  • Faz 5 — README: profesyonel/reklamsız ton (badge yağmuru→3, pazarlama klişeleri + yıldız-dilenme + rakip-tablosu kaldırıldı, yazar atfı eklendi); sayılar gerçeğe eşlendi (125 deep-dive, 9 cheatsheet, 19 template, ~66K satır). 3-mercek adversarial review uygulandı.
  • Faz 6 — Keşfedilebilirlik: 190 dosyaya SEO description frontmatter; eksik 17-Templates/terraform/ + gitignore/ template'leri eklendi; kırık linkler düzeltildi.

Doğrulama (yerel)

Kontrol Sonuç
mkdocs build --strict ✅ EXIT 0 — 0 WARNING / 0 ERROR
Kırık iç-link tarama ✅ 0
Frontmatter bütünlüğü ✅ 0 eksik / 0 bozuk
Leak guard (AWS key / public IPv4) ✅ temiz
İçerik-koruma (RoadMap bölme) ✅ 8568 satır byte-eksiksiz

Açıkça raporlanan silmeler

Yalnız README pazarlama bloğu (teknik içerik DEĞİL): "en kapsamlı" iddiası, rakip-karşılaştırma tablosu, yıldız-dilenme bölümleri, star-history, badge yağmuru, SEO keyword-stuffing <details> bloğu. Detay → CHANGES-SUMMARY.md §4.

🤖 Generated with Claude Code

halilibrahimd27 and others added 10 commits June 27, 2026 11:06
@halilibrahimd27 @claude
docs: Faz 0 — read-only denetim raporu (AUDIT.md)
48180e9 
DevOps Notebook reposunun kapsamlı denetimi: envanter (iddia↔gerçek),
CLAUDE.md anatomi uyumu, oversized dosyalar, adlandırma tutarsızlıkları,
eski klasör stratejisi seçenekleri, bayat/junk, placeholder/kredibilite,
SEO ve fazlara eşli önceliklendirilmiş aksiyon listesi.

Hiçbir içerik değiştirilmedi (yalnız AUDIT.md eklendi). Karar bekleyen
maddeler ❓ KARAR ile işaretli.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@halilibrahimd27 @claude
refactor(structure): Faz 1 — saha notlarını 21-Field-Notes/ altında t…
666176f 
…opla + kebab-case + build senkron

Yapısal hijyen (AUDIT.md §4-6):
- 5 ad-hoc klasör (System/Network/Ansible/Terraform/Kubectl) → 21-Field-Notes/
  alt-klasörlerine git mv; tüm dosyalar kebab-case + .md uzantısı
  (5 uzantısız + 2 H2-başlangıçlı dosya geçerli markdown'a çevrildi: H1 +
  ham script'ler ```bash/```hcl fence içine; içerik %100 korundu)
- Yazım hataları: Preperation→preparation, Manuel→modules
- RoadMap top-level "Yol Haritası" olarak korundu (sitenin hero öğrenme yolu);
  "Advanced RoadMap.md" → "advanced-roadmap.md"
- 21-Field-Notes/README.md index eklendi
- İç linkler senkron: Network→21-Field-Notes (08-Security, 07-Observability x4),
  README + RoadMap/README Advanced linki
- scripts/build-docs.sh: numaralı glob 21'i kapsar, eski klasör kopyalama/TITLES/
  nav kaldırıldı, 21-Field-Notes + RoadMap alt başlıkları eklendi
- mkdocs.yml exclude_docs: bayat LAUNCH-PLAN.md + taşınan Ansible kaydı +
  gitignore'lı MARKETING.md çıkarıldı; AUDIT/CHANGES-SUMMARY eklendi

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@halilibrahimd27 @claude
docs(roadmap): Faz 2 — advanced-roadmap.md (8568 satır) → 14 faz sayf…
5538fb3 
…ası + index

AUDIT.md §3: tek dosya 217KB/8568 satırdı. PHASE sınırlarında bölündü:
- RoadMap/advanced/00-prerequisites … 13-quickstart-30min.md (14 sayfa)
- advanced-roadmap.md artık 28 günlük planın linkli index'i (orijinal
  başlık+alt-başlık korundu)
- İçerik %100 korundu (Python assertion: satır 6..8568 byte-eksiksiz dağıtıldı;
  tek değişiklik her sayfanın ilk ## → # H1 promote + quickstart H1 düzeltme)
- build-docs.sh RoadMap nav'ına "advanced/" alt-klasörü eklendi
- Dosya-içi/dışı anchor link yoktu → kırık link riski sıfır

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@halilibrahimd27 @claude
docs(readme): Faz 5 — README'yi profesyonel/reklamsız tona çek + sayı…
03638eb 
…ları gerçeğe eşle

AUDIT.md §8 (CLAUDE.md "pazarlama tonu yasak" ihlali):
- Badge yağmuru (8+ shields + Awesome) → 3 anlamlı badge (site, license, last-commit)
- Kaldırıldı: "Türkiye'nin en kapsamlı", yıldız-dilenme blokları,
  "rakip-dövme" karşılaştırma tablosu, "desteklemek istiyorsan" + star-history
- Sayılar gerçeğe eşlendi: 125+ → 125 deep-dive, 25+ → 19 template,
  64K → ~66K satır; "production-tested" → dürüst "production'da yaşanıp damıtılmış"
- KIRIK link düzeltmesi: eski Ansible/System/Network/Terraform/Kubectl klasör
  linkleri → tek "21-Field-Notes" satırı (Faz 1 taşımasıyla senkron)
- Korundu: görev-bazlı Hızlı Başlangıç tablosu, İçindekiler, mimari diyagram,
  repo felsefesi, yan-repolar, keywords (<details> içinde)
- mkdocs.yml site_description: 125+/25+ → 125/19

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@halilibrahimd27 @claude
docs(readme): Faz 5 review — adversarial review düzeltmeleri
10dbea0 
3-mercek adversarial review (anayasa/doğruluk/kıdemli) bulguları:
- SEO keyword-stuffing <details> bloğu kaldırıldı (README'nin kendi
  "buzzword listesi değil" felsefesiyle çelişiyordu — CLAUDE.md ihlali)
- Geçersiz shields rengi deeppurple → 8A2BE2 (ilk badge kırık görünüyordu)
- Yazar atfı eklendi (Halil İbrahim Dürmüş — portfolyo/kredibilite varlığı)
- "production'da yaşanıp damıtılmış" → "production senaryolarına göre yazılmış,
  21-Field-Notes ile desteklenen" (dürüst çerçeve)
- Hızlı Başlangıç tekrar eden emoji ayrıldı (🔥→🪫 on-call, 🏗️→🧩 IDP)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@halilibrahimd27 @claude
fix(placeholder): Faz 4 — credential/placeholder hijyeni + action ver…
090ebcb 
…siyon pin

AUDIT.md §7 (CLAUDE.md placeholder kırmızı-çizgisi):
- Terraform cipassword zayıf hardcoded "ubuntu" → <CI_PASSWORD> (18 yer:
  modules-create-vm 13 + proxmox-configuration 5)
- System repo-layout zayıf parola örnekleri → <DB_PASSWORD>/<ROOT_PASSWORD>/
  <REDIS_PASSWORD>/<GRAFANA_PASSWORD> (7 yer)
- GitHub Action full-semver pin osv-scanner-action@v1.7.0 → @<VERSION>
- Network guide: 85 RFC-1918 örnek IP mangle edilmedi; yerine segmentasyon
  dersini koruyan açık "RFC 1918 örnek" disclaimer notu eklendi
- Bilinçli bırakıldı: image-tag semver'leri (node:22.11.0 vb. "sürüm pin'le"
  dersi), @v1.2.3 semver-format örneği, @v4 idiomatik major-pin

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@halilibrahimd27 @claude
docs(content): Faz 3 — eksik anti-pattern tabloları + checklist'ler (…
82b03ee 
…CLAUDE.md anatomi)

AUDIT.md §2 (düzeltilmiş gerçek rakam: 7 anti-pattern + 13 checklist eksikti):
- 7 dosyaya anti-pattern tablosu eklendi (8-11 satır, 3 sütun, domain-spesifik)
- 12 dosyaya production checklist eklendi ([ ] maddeleri, somut)
- 05-Kubernetes/Production-Checklist.md: zaten baştan sona checklist olduğu için
  jenerik checklist eklenmedi (bilinçli, gerekçeli skip); anti-pattern eklendi
- Tümü dosyanın gerçek konusuna dayalı — uydurma YOK; CLAUDE.md yargılı/eylemsel
  Türkçe sesinde; referans/kapanıştan önce doğru yerleşim
- AUDIT.md §2: hatalı "1/125" rakamı düzeltildi (zsh word-splitting artefaktıydı)

15 dosya ultracode workflow ile işlendi: dosya başına ekleme + bağımsız
adversarial doğrulama (15/15 pass, 0 uydurma riski).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@halilibrahimd27 @claude
docs(seo): Faz 6 — SEO description frontmatter + link bütünlüğü + eks…
67a9e09 
…ik template'ler

Keşfedilebilirlik (AUDIT.md §9):
- 190 içerik dosyasına YAML frontmatter `description` eklendi (MkDocs Material
  meta açıklaması; arama + sosyal paylaşma önizlemesi). 0 atlandı, içerik korundu.
  (folder-bazlı 23-agent ultracode workflow; bütünlük: 0 eksik/0 bozuk doğrulandı)
- Bilinçli kapsam-dışı: tags frontmatter (plugin yok → inert), kütle mermaid +
  çapraz-link (churn; ASCII diyagram + bölüm index'leri navigasyonu sağlıyor)

Link bütünlüğü (Faz 2 bölme artefaktları + pre-existing):
- RoadMap/advanced/13-quickstart-30min.md: README.md → ../advanced-roadmap.md;
  docs/troubleshooting.md kırık linki açıklayıcı metne çevrildi
- 11-SRE/SLI-SLO-Error-Budget.md: prometheus-rules/ dizin linki → spesifik .yaml
- 18-Career/CV-Tips.md: (...) placeholder URL → <YOUR_BLOG> placeholder

Eksik template'ler (17-Templates/README'nin vaat ettiği ama olmayan):
- 17-Templates/terraform/ (README + main.tf + variables.tf + outputs.tf —
  tip-güvenli/validation'lı modül iskeleti)
- 17-Templates/gitignore/ (stack başına .gitignore örnekleri + anti-pattern)

Doğrulama: `mkdocs build --strict` EXIT 0, 0 WARNING/ERROR; kırık-link tarama 0.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@halilibrahimd27 @claude
docs: Faz 7 — kapanış: CHANGELOG + CHANGES-SUMMARY + build doğrulama
0824b60 
- CHANGELOG.md [Unreleased]: repo-cilası özeti (Keep a Changelog formatı)
- CHANGES-SUMMARY.md: tam şeffaflık belgesi — taşıma haritası, eklenenler,
  açıkça raporlanan README pazarlama-bloğu silmeleri, doğrulama tablosu,
  gerekçeli kapsam-dışı kararlar
- AUDIT.md + CHANGES-SUMMARY.md exclude_docs'ta (site'a girmez)

Doğrulama (yerel, bash 5 + mkdocs venv):
- mkdocs build --strict: EXIT 0, 0 WARNING/ERROR
- kırık-link tarama: 0 | frontmatter bütünlüğü: 0 eksik/bozuk
- leak guard: temiz (AWS key yok; doc-range/Google-DNS IP'leri meşru)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@halilibrahimd27 @claude
feat(site): konu etiketleri (Material tags) + etiket indeks sayfası
61ade3c 
Keşfedilebilirlik eklentisi:
- mkdocs.yml: Material `tags` plugin etkin (deprecated tags_file yerine
  marker-tabanlı; 9.7.6 uyumlu)
- docs/tags.md: etiket indeks sayfası (<!-- material/tags --> marker) + nav'a eklendi
- scripts/build-docs.sh: tags.md staging + nav girdisi
- 192 dosyaya kontrollü-vocabulary `tags` frontmatter (folder-bazlı ultracode
  workflow): 47 benzersiz etiket (Kubernetes 66, Security 53, SRE 46, CI/CD 35…),
  fragmente değil — her dosyada klasör birincil etiketi + ilgili konular

Doğrulama: tüm frontmatter YAML geçerli (0 bozuk); mkdocs build --strict
EXIT 0, 0 uyarı; tags sayfası dolu (189KB).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@halilibrahimd27
halilibrahimd27 merged commit c34f19c into main Jun 28, 2026
3 checks passed
@halilibrahimd27
halilibrahimd27 deleted the chore/repo-polish branch June 28, 2026 07:13
halilibrahimd27 added a commit that referenced this pull request Jul 22, 2026
@halilibrahimd27 @claude
feat(learning-path): Faz 7 tamam — Blok F içerik + PORTFOLIO + kariye…
3167041 
…r köprüsü (§10)

F1–F5 modülleri üçüncü bakış çerçevesiyle yazıldı (aynı sistemlere para/
organizasyon/risk gözüyle dönüş). Her modül mevcut deep-dive'lara link
veren sıralayıcı (kısıt #1), teslim egzersizi yazılı çıktıyla doğrulanabilir:
- F1 maliyet ayrımı + trade-off (finops-analiz.md)
- F2 STRIDE tehdit modeli + KVKK/SOC2 kontrol/kanıt eşleme (tehdit-modeli.md)
- F3 platform/golden-path/Team Topologies ("ne zaman erken" — NOT-YET)
- F4 ADR + rubrikli postmortem (yazma egzersizi)
- F5 gerekçeli "hayır" + vendor/kilitlenme (karar-yazisi.md)

PORTFOLIO.md (§5 kök dosya): modül/capstone → CV satırı eşlemesi, kanıt→etki
ilkesi, anti-pattern tablosu, checklist. Ünvan iddiası reddedildi, CV
metrikleri <...> placeholder (uydurma sayı yok).

Kariyer köprüsü: CV-Tips.md ile çift yönlü bağ (§10 Faz 7 adlı istisnası,
tek satır); README tablosu + F5 "Sırada" + CAP1–3 PORTFOLIO canlı link.

F toplam=48s (revizyon 4 planı F48 tutuyor). QA exit 0 (0 uyarı);
§14.3 self-check temiz (tekrar/pazarlama/süre).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
halilibrahimd27 added a commit that referenced this pull request Jul 23, 2026
@halilibrahimd27 @claude
feat(learning-path): Faz 9.5 kısmen — A0 modülü + entegrasyon (EN twi…
1a9b53d 
…n PAUSE)

A0 "Başlamadan Önce" beginner ısınma modülü (330s, TR): ortam kurulumu,
terminal ergonomisi, gezinme/yardım minimumu, nano, patika kullanım kılavuzu.
A1'in sistem-derinliğiyle örtüşmez (kısıt #1); kurulum COST-GUARDRAILS'e devreder.

Entegrasyon: A1 önkoşulu [A0] (DAG A0→A1) · CURRICULUM (satır+mermaid+30 modül/
~483s+"A0 tek giriş") · README (rampa/A0…F5/~483s) · PLACEMENT (yeni-mezun A0) ·
COST-GUARDRAILS başlık A0/A1 · MODULE-SPEC onay-sonrası ek (şeffaflık).

QA exit 0 (30 modül), iki-locale build temiz, §14.3 self-check (tekrar/pazarlama/
süre) temiz. Blok A 97→103, toplam 477→483.

EN twin katmanı hâlâ qa.py-bloke (§15.4 — dokunamam); .local/PAUSE oluşturuldu:
kullanıcı qa.py'yi .en.md locale dosyalarını modül denetiminden ayıracak şekilde
genişletince döngü devam eder.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
halilibrahimd27 added a commit that referenced this pull request Jul 25, 2026
@halilibrahimd27 @claude
feat(learning-path): Faz 2 tamam — Blok B derinleştirildi (B1–B3)
da47ae7 
B1/B2/B3 qa.py <300s derinlik uyarısını temizle (357/303/306s),
kısıt #1'i ihlal etmeden özgün beginner içerikle:
- B1: journalctl derinliği (biçim/alan süzgeci/-b -1/kalıcı journal/rate-limit)
- B2: anlık↔aralık vektör + scrape yaşam döngüsü + meta-metrik (deep-dive'a devir korundu)
- B3: uçtan-uca DNS teşhis yürüyüşü (K01 örtüşmez) + zaman kutusu/eskalasyon

Faz 2 (A1–A6 + B1–B3, 9 modül) tamam. QA exit 0, 0 uyarı.
Blok A+B toplam 133s (A97·B36). Sıradaki: Faz 3 (Blok C+D).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
halilibrahimd27 added a commit that referenced this pull request Jul 25, 2026
@halilibrahimd27 @claude
feat(learning-path): Faz 7 tamam — Blok F içerik + PORTFOLIO + kariye…
3ac9652 
…r köprüsü (§10)

F1–F5 modülleri üçüncü bakış çerçevesiyle yazıldı (aynı sistemlere para/
organizasyon/risk gözüyle dönüş). Her modül mevcut deep-dive'lara link
veren sıralayıcı (kısıt #1), teslim egzersizi yazılı çıktıyla doğrulanabilir:
- F1 maliyet ayrımı + trade-off (finops-analiz.md)
- F2 STRIDE tehdit modeli + KVKK/SOC2 kontrol/kanıt eşleme (tehdit-modeli.md)
- F3 platform/golden-path/Team Topologies ("ne zaman erken" — NOT-YET)
- F4 ADR + rubrikli postmortem (yazma egzersizi)
- F5 gerekçeli "hayır" + vendor/kilitlenme (karar-yazisi.md)

PORTFOLIO.md (§5 kök dosya): modül/capstone → CV satırı eşlemesi, kanıt→etki
ilkesi, anti-pattern tablosu, checklist. Ünvan iddiası reddedildi, CV
metrikleri <...> placeholder (uydurma sayı yok).

Kariyer köprüsü: CV-Tips.md ile çift yönlü bağ (§10 Faz 7 adlı istisnası,
tek satır); README tablosu + F5 "Sırada" + CAP1–3 PORTFOLIO canlı link.

F toplam=48s (revizyon 4 planı F48 tutuyor). QA exit 0 (0 uyarı);
§14.3 self-check temiz (tekrar/pazarlama/süre).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
halilibrahimd27 added a commit that referenced this pull request Jul 25, 2026
@halilibrahimd27 @claude
feat(learning-path): Faz 9.5 kısmen — A0 modülü + entegrasyon (EN twi…
09977a7 
…n PAUSE)

A0 "Başlamadan Önce" beginner ısınma modülü (330s, TR): ortam kurulumu,
terminal ergonomisi, gezinme/yardım minimumu, nano, patika kullanım kılavuzu.
A1'in sistem-derinliğiyle örtüşmez (kısıt #1); kurulum COST-GUARDRAILS'e devreder.

Entegrasyon: A1 önkoşulu [A0] (DAG A0→A1) · CURRICULUM (satır+mermaid+30 modül/
~483s+"A0 tek giriş") · README (rampa/A0…F5/~483s) · PLACEMENT (yeni-mezun A0) ·
COST-GUARDRAILS başlık A0/A1 · MODULE-SPEC onay-sonrası ek (şeffaflık).

QA exit 0 (30 modül), iki-locale build temiz, §14.3 self-check (tekrar/pazarlama/
süre) temiz. Blok A 97→103, toplam 477→483.

EN twin katmanı hâlâ qa.py-bloke (§15.4 — dokunamam); .local/PAUSE oluşturuldu:
kullanıcı qa.py'yi .en.md locale dosyalarını modül denetiminden ayıracak şekilde
genişletince döngü devam eder.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@halilibrahimd27