chore: repo cilası — yapısal hijyen, README profesyonelleştirme, SEO, anatomi tamamlama#1
Merged
Merged
Conversation
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>
…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>
…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>
…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>
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>
…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>
…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>
…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>
- 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>
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Ö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
21-Field-Notes/bölümü; tümü kebab-case + geçerli markdown. build-docs.sh/mkdocs.yml senkron.RoadMap/Advanced RoadMap.md(8568 satır/217KB) → 14 faz sayfası + linkli index.<PLACEHOLDER>, action full-semver pin →@<VERSION>, Network RFC-1918 disclaimer.descriptionfrontmatter; eksik17-Templates/terraform/+gitignore/template'leri eklendi; kırık linkler düzeltildi.Doğrulama (yerel)
mkdocs build --strictAçı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