Skip to content

docs(doku): DE-Sprachvarianten fuer Lang-Switch vervollstaendigen#80

Merged
tomtastisch merged 2 commits intomainfrom
codex/docs/de-translation-switch-fixes
Feb 16, 2026
Merged

docs(doku): DE-Sprachvarianten fuer Lang-Switch vervollstaendigen#80
tomtastisch merged 2 commits intomainfrom
codex/docs/de-translation-switch-fixes

Conversation

@tomtastisch
Copy link
Owner

Ziel & Scope

Die betroffenen DE-Dokumente fuer den Sprach-Switch (0NN_*.MD) werden inhaltlich auf Deutsch gebracht, damit der Wechsel von EN nach DE nicht mehr auf englische Inhalte fuehrt. Scope ist ausschliesslich docs/** in den identifizierten 14 Dateien; EN-Pendants (1NN_*.MD) bleiben unveraendert.

Umgesetzte Aufgaben (abhaken)

  • 14 betroffene DE-Dateien identifiziert und fokussiert bearbeitet.
  • docs/governance/001_POLICY_CI.MD vollstaendig auf Deutsch ueberfuehrt.
  • docs/governance/002_POLICY_LABELING.MD vollstaendig auf Deutsch ueberfuehrt.
  • docs/governance/002_POLICY_NAMING_UNIFIED.MD vollstaendig auf Deutsch ueberfuehrt.
  • docs/governance/003_INDEX_GOVERNANCE.MD und docs/governance/003_POLICY_VERSIONING_SVT.MD auf Deutsch ueberfuehrt.
  • docs/governance/006_INDEX_CI_RULES.MD und docs/guides/004_GUIDE_MIGRATE_LEGACY_NUGET.MD auf Deutsch ueberfuehrt.
  • Audit-/CI-Dokumente sprachlich normalisiert: docs/audit/000_INDEX.MD, docs/audit/003_SECURITY_ASSERTION_TRACEABILITY.MD, docs/audit/009_SUPPLY_CHAIN_BASELINE.MD, docs/audit/011_SECURITY_BENCHMARK.MD, docs/audit/015_DOC_BILINGUAL_MAPPING.MD, docs/ci/001_PIPELINE_CI.MD.
  • docs/versioning/002_HISTORY_VERSIONS.MD sprachlich ueberarbeitet und fuer Original-Committitel als Quellnachweis dokumentiert.

Nachbesserungen aus Review (iterativ)

  • Sprachwechsel-Beispiel docs/governance/101_POLICY_CI.MD -> docs/governance/001_POLICY_CI.MD gezielt validiert.
  • Begriffe in Tabellen/Ueberschriften von EN auf DE normalisiert (z. B. DE_PATH/EN_PATH -> DE_PFAD/EN_PFAD).
  • Fachliche Terminologie in DE-Dokumenten vereinheitlicht (Geltungsbereich, Nachweis, Richtlinie, Kontroll-Basislinie).

Security- und Merge-Gates

  • security/code-scanning/tools: 0 offene Alerts als Merge-Gate berücksichtigt.
  • Keine Secrets in Logs oder Dokumenten hinzugefuegt.
  • Keine Aenderung an Security-Workflow-Rechten oder Action-Pinning.
  • Merge nur bei gruenen Required Checks und ohne offene Review-Threads.

Evidence (auditierbar)

  • Doku-Checks:
    • python3 tools/check-docs.py => Doc check OK
    • python3 tools/check-doc-consistency.py => Doc consistency check OK
    • python3 tools/check-doc-shell-compat.py => Doc shell compatibility check OK
  • Build/Test/Security:
    • dotnet build FileClassifier.sln -c Release => 0 Warnung(en), 0 Fehler
    • dotnet test FileClassifier.sln -c Release --no-build => 413 erfolgreich, 0 Fehler
    • dotnet list FileClassifier.sln package --vulnerable --include-transitive => keine anfaelligen Pakete
    • dotnet format FileClassifier.sln --verify-no-changes => erfolgreich
  • Geaenderte Artefakte:
    • docs/audit/000_INDEX.MD
    • docs/audit/003_SECURITY_ASSERTION_TRACEABILITY.MD
    • docs/audit/009_SUPPLY_CHAIN_BASELINE.MD
    • docs/audit/011_SECURITY_BENCHMARK.MD
    • docs/audit/015_DOC_BILINGUAL_MAPPING.MD
    • docs/ci/001_PIPELINE_CI.MD
    • docs/governance/001_POLICY_CI.MD
    • docs/governance/002_POLICY_LABELING.MD
    • docs/governance/002_POLICY_NAMING_UNIFIED.MD
    • docs/governance/003_INDEX_GOVERNANCE.MD
    • docs/governance/003_POLICY_VERSIONING_SVT.MD
    • docs/governance/006_INDEX_CI_RULES.MD
    • docs/guides/004_GUIDE_MIGRATE_LEGACY_NUGET.MD
    • docs/versioning/002_HISTORY_VERSIONS.MD

DoD (mindestens 2 pro Punkt)

Umgesetzter Punkt DoD A (auditierbar) DoD B (auditierbar) Evidence
Governance-DE-Inhalte DE-Dateien enthalten deutsche Ueberschriften/Abschnitte EN-Pendants bleiben unangetastet Diff auf docs/governance/*.MD, Link-Header unveraendert
Audit/CI-DE-Normalisierung Tabellen-/Abschnittsbegriffe sind in DE normalisiert Sprachswitch-Zielfall zeigt deutsche Inhalte docs/audit/*.MD, docs/ci/001_PIPELINE_CI.MD, manuelle Validierung 101->001
Versionshistorie-DE-Verbesserung Einleitungs-/Hinweistexte sind deutsch und klar Quellnachweis fuer Original-Committitel dokumentiert docs/versioning/002_HISTORY_VERSIONS.MD
Repo-Qualitaet Doku-Checks laufen gruen Build/Test/Vulnerability-Checks laufen gruen oben genannte Befehle mit Exit 0

Copilot AI review requested due to automatic review settings February 16, 2026 07:35
@github-actions github-actions bot added area:docs area:versioning impl:security docs Documentation change versioning:patch Fix/Refactor/Docs/CI/Tooling; requires PATCH bump labels Feb 16, 2026
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Diese PR vervollstaendigt die deutschen Sprachvarianten der Lang-Switch-Dokumente (0NN_*.MD), damit ein Wechsel von EN nach DE nicht mehr auf englische Inhalte fuehrt und die DE-Dokumente terminologisch konsistent sind.

Changes:

  • Uebersetzungen/Sprachnormalisierung in 14 DE-Dokumenten unter docs/** (Governance, CI, Audit, Guides, Versioning).
  • Terminologieanpassungen in Ueberschriften/Tabellen (z. B. Geltungsbereich/Nachweis) sowie DE-Labels in Mapping- und Evidence-Abschnitten.
  • Ergaenzung eines Hinweises zur Versionshistorie (Keyword-Spalte/Original-Committitel).

Reviewed changes

Copilot reviewed 14 out of 14 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
docs/versioning/002_HISTORY_VERSIONS.MD DE-Text fuer Versionshistorie erweitert/vereinheitlicht, inkl. Hinweis zu Keywords/Originaltiteln
docs/guides/004_GUIDE_MIGRATE_LEGACY_NUGET.MD Guide von EN nach DE ueberfuehrt (Migration, Policy-Hinweise)
docs/governance/006_INDEX_CI_RULES.MD CI-Regelindex von EN nach DE ueberfuehrt (Ueberschrift/Tabellenkoepfe)
docs/governance/003_POLICY_VERSIONING_SVT.MD SVT-Policy von EN nach DE ueberfuehrt (SHALL-Statements, Mapping)
docs/governance/003_INDEX_GOVERNANCE.MD Governance-Index von EN nach DE ueberfuehrt
docs/governance/002_POLICY_NAMING_UNIFIED.MD Naming-Policy von EN nach DE ueberfuehrt
docs/governance/002_POLICY_LABELING.MD Labeling-Ownership-Policy von EN nach DE ueberfuehrt
docs/governance/001_POLICY_CI.MD CI-Policy (SSOT) von EN nach DE ueberfuehrt
docs/ci/001_PIPELINE_CI.MD CI-Pipeline-Dokument sprachlich weiter normalisiert (Nachweis/Evidence-Begriffe etc.)
docs/audit/015_DOC_BILINGUAL_MAPPING.MD Mapping-Report sprachlich normalisiert (DE-Spalten/Labels, Ausgabe-Labels)
docs/audit/011_SECURITY_BENCHMARK.MD Benchmark sprachlich normalisiert (Ueberschrift/Terminologie, Erklaertexte)
docs/audit/009_SUPPLY_CHAIN_BASELINE.MD Supply-Chain-Baseline sprachlich normalisiert (Basislinie/Nachweise)
docs/audit/003_SECURITY_ASSERTION_TRACEABILITY.MD Traceability-Dokument sprachlich normalisiert (Begriffe/Tabellenkoepfe)
docs/audit/000_INDEX.MD Audit-Index sprachlich normalisiert (Geltungsbereich/Nachweise)

@tomtastisch tomtastisch enabled auto-merge (squash) February 16, 2026 07:39
@tomtastisch tomtastisch merged commit 52c9dbe into main Feb 16, 2026
26 checks passed
@tomtastisch tomtastisch deleted the codex/docs/de-translation-switch-fixes branch February 16, 2026 07:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:docs area:versioning docs Documentation change impl:security versioning:patch Fix/Refactor/Docs/CI/Tooling; requires PATCH bump

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant