| 1 | # Engineering Reading Domain Status v1 |
| 2 | |
| 3 | ## Scope |
| 4 | |
| 5 | Evidence-based reading system for .NET/C# engineering decisions (language, runtime, testing, architecture, data, operations, compilers, F#, OS environments). |
| 6 | |
| 7 | ## Completion State |
| 8 | |
| 9 | Status: **Done v1 (Foundation Layer)** |
| 10 | |
| 11 | Primary artifact: **`kb-engineering-evidence-v1.md`** — база знаний по темам (evidence, не список книг). Map — справочник источников; digest — архив/legacy. |
| 12 | |
| 13 | Completed artifacts: |
| 14 | |
| 15 | - `kb-engineering-evidence-v1.md` |
| 16 | - `kb-mcconnell-code-complete-2-chapter-map-v1.md` (карта глав *Code Complete* 2nd ed., evidence-протокол, локальный source в карточке) |
| 17 | - `map-engineering-reading-v1.md` |
| 18 | - `digest-engineering-reading-v1.md` (legacy; выписки перенесены в kb) |
| 19 | - `status-engineering-reading-v1.md` |
| 20 | |
| 21 | ## Definition of Done Check |
| 22 | |
| 23 | - Version baseline (C# 14 / .NET 10+) fixed: done. |
| 24 | - Multi-track literature map with ingestion contract: done. |
| 25 | - Digest has multi-batch distilled entries with adoption tasks/confidence: done. |
| 26 | - Track H (Windows/Linux) includes explicit applied examples: done. |
| 27 | - Index synchronization: done. |
| 28 | |
| 29 | ## Active Guardrails |
| 30 | |
| 31 | - Read for transfer, not for volume. |
| 32 | - Promote only techniques with measurable workflow impact. |
| 33 | - Keep confidence proportional to repeated practical usage. |
| 34 | - Separate stable fundamentals from fast-changing platform guidance. |
| 35 | |
| 36 | ## Remaining Backlog (Out of v1 Closure) |
| 37 | |
| 38 | - Continue Phase C expansion (cloud/platform engineering, architecture economics, large-scale diagnostics). |
| 39 | - Periodic freshness pass for high-volatility official docs. |
| 40 | |
| 41 | ### Legacy / compatibility bridge (.NET Framework → .NET) |
| 42 | |
| 43 | - For legacy .NET Framework topics (1.0–4.x history, CLR 2.0/3.5 vs CLR 4.0, supported combinations, migration decisions) **не открывать новый домен**: использовать тонкий мостовой слой поверх этого фонда: |
| 44 | - `worlds/software-dotnet-csharp/kb-dotnet-fundamentals-v1.md` — конспект по линиям .NET, TFMs, моделям приложений и границам .NET↔native; |
| 45 | - блок `.NET Framework history and compatibility (1.0 → 4.x)` внутри `kb-engineering-evidence-v1.md` — факты/эвиденция по истории/совместимости; |
| 46 | - `worlds/software-dotnet-csharp/kb-dotnet-playbooks-v1.md` — короткие playbook’и (выбор TFM/версии, оценка миграции с .NET Framework, базовый диагностический цикл). |
| 47 | - Глубинные диагностические/отладочные дорожки остаются в существующих playbook’ах (`worlds/software-dotnet-tooling-roslyn/dotnet-roslyn-debug-playbook.md`, `tooling-debug-playbook.md`, `worlds/software-dotnet-csharp/frontend-dotnet-playbook.md`) и считаются продолжением этого же домена. |
| 48 | |
| 49 | ## Next sources to ingest (Queue) |
| 50 | |
| 51 | При следующем чтении — кандидаты для выписок в `kb-engineering-evidence-v1.md` (по темам, формат: Fact, Heuristic, First adoption task, Success criterion, Confidence, Source). Приоритет по map и потребности проекта. |
| 52 | |
| 53 | - C# in Depth (Skeet) — семантика языка, скрытые острые края. |
| 54 | - Pro .NET Memory Management (Kokosa) — GC и стратегии аллокаций. |
| 55 | - xUnit Test Patterns (Meszaros) — каталог тестовых запахов и ремедиация. |
| 56 | - Working Effectively with Legacy Code (Feathers) — восстановление через швы (seam-first). |
| 57 | - Designing Data-Intensive Applications (Kleppmann) — tradeoffs данных и систем. |
| 58 | |
| 59 | ## Alias Window |
| 60 | |
| 61 | Closed. Legacy aliases were retired after semantic-primary stabilization. |
| 62 | |
| 63 | ## Next Domain Handoff |
| 64 | |
| 65 | Engineering-reading foundation closed at v1. |
| 66 | Next step: move to remaining pending technical domain, then run naming/index cleanup. |
| 67 | |
| 68 | |