Technische Dokumentation, Werkzeuge und Beruf — unabhängiges Magazin
TECHWRITERS.ORG

CI/CD

Artikel mit Tag: CI/CD

Dokumentation in CI/CD
Werkzeuge

Dokumentation in CI/CD

Dokumentation als Build-Artefakt behandeln: Struktur, Links, Beispiele und Publikationsregeln vor der Veröffentlichung prüfen. CI kann nicht beurteilen, ob eine Erklärung nützlich ist, aber vorhersehbare Defekte vor dem menschlichen Review abfangen.

Technische redaktionelle Illustration zum Artikel: Vale als Quality Gate statt als Zeichensetzungspolizei.
Werkzeuge

Vale als Quality Gate statt als Zeichensetzungspolizei

Style Linting ist wertvoll, wenn es Terminologiedrift, riskante Formulierungen und wiederholbare redaktionelle Fehler findet. Halte Regeln klein, erklärbar und so leise, dass ein Fehlschlag ernst genommen wird. Ein Linter kann Tausende Sätze in Sekunden prüfen, deshalb ist die Versuchung groß, jede Stilpräferenz zu kodieren.