https://techwriters.org/de/TechWriters localized technical-writing feed.https://techwriters.org/de/articles/accessible-code-examples-and-tables/https://techwriters.org/de/articles/accessible-code-examples-and-tables/Thu, 13 Aug 2026 00:00:00 GMTBarrierefreiheit in der Dokumentation endet nicht bei Navigation und Kontrast. Auch Codebeispiele, JSON-Antworten und Referenztabellen müssen ohne reine Farbcodierung verständlich und nutzbar bleiben.https://techwriters.org/de/articles/ai-as-editor-not-oracle/https://techwriters.org/de/articles/ai-as-editor-not-oracle/Thu, 13 Aug 2026 00:00:00 GMTEin praktischer und prüfbarer Ansatz für „KI als Redakteur nutzen, nicht als Orakel“, der langfristig wartbare Dokumentation unterstützt. „KI als Redakteur nutzen, nicht als Orakel“ mit einem praktischen, prüfbaren und wartbaren Ansatz für technische Dokumentation.https://techwriters.org/de/articles/ai-fact-checking-for-docs/https://techwriters.org/de/articles/ai-fact-checking-for-docs/Thu, 13 Aug 2026 00:00:00 GMTGenerativer Text kann vollständig klingen und dabei Defaults, Garantien oder Quellen erfinden. Baue Verifikation um autoritative Quellen, ausführbare Beispiele und sichtbare Unsicherheit. Der gefährliche AI-Fehler in Dokumentation ist selten schlechte Grammatik.https://techwriters.org/de/articles/ai-learned-to-write-documentation/https://techwriters.org/de/articles/ai-learned-to-write-documentation/Thu, 13 Aug 2026 00:00:00 GMTIn drei Jahren hat generative KI den ersten Entwurf von einem teuren Ergebnis zu einer billigen Operation gemacht. Entscheidend ist heute, wer Fakten, Struktur, Review, Aktualisierung und Qualität verantwortet.https://techwriters.org/de/articles/api-examples-that-teach/https://techwriters.org/de/articles/api-examples-that-teach/Thu, 13 Aug 2026 00:00:00 GMTEin technisch gültiger Request ist noch kein gutes Beispiel. Verwende realistische Werte und Sequenzen, die das mentale Modell der API zeigen und den nächsten Schritt vorhersehbar machen. Ein aus dem Schema erzeugtes Beispiel kann syntaktisch korrekt und didaktisch wertlos sein.https://techwriters.org/de/articles/authentication-docs-that-prevent-support-tickets/https://techwriters.org/de/articles/authentication-docs-that-prevent-support-tickets/Thu, 13 Aug 2026 00:00:00 GMTEin praktischer und prüfbarer Ansatz für „Authentifizierungsdokumentation, die Support-Tickets verhindert“, der langfristig wartbare Dokumentation unterstützt. „Authentifizierungsdokumentation, die Support-Tickets verhindert“ mit einem praktischen, prüfbaren und wartbaren Ansatz für technische Dokumentation.https://techwriters.org/de/articles/books-and-guides-for-technical-writers/https://techwriters.org/de/articles/books-and-guides-for-technical-writers/Thu, 13 Aug 2026 00:00:00 GMTEine nützliche Leseliste ist heute keine Sammlung von Klassikern. Vergleichen Sie aktuelle Leitfäden von Microsoft, Google, GitHub und IBM, prüfen Sie Strukturen mit Diátaxis und machen Sie aus jeder Lektüre eine konkrete Dokumentationsübung.https://techwriters.org/de/articles/choosing-a-docs-generator/https://techwriters.org/de/articles/choosing-a-docs-generator/Thu, 13 Aug 2026 00:00:00 GMTSphinx, MkDocs, Astro und andere Generatoren optimieren unterschiedliche Content Models und Teams. Entscheide nach Authoring Workflow, Erweiterbarkeit, Lokalisierung und Wartungskosten statt nach einer schönen Demo. Eine beeindruckende Demo kann für deine Dokumentation trotzdem falsch sein.https://techwriters.org/de/articles/choosing-search-for-docs/https://techwriters.org/de/articles/choosing-search-for-docs/Thu, 13 Aug 2026 00:00:00 GMTEin praktischer und prüfbarer Ansatz für „Suche für Dokumentation wählen: bei Fehlerszenarien beginnen“, der langfristig wartbare Dokumentation unterstützt. „Suche für Dokumentation wählen: bei Fehlerszenarien beginnen“ mit einem praktischen, prüfbaren und wartbaren Ansatz für technische Dokumentation.https://techwriters.org/de/articles/deliberate-practice-for-docs/https://techwriters.org/de/articles/deliberate-practice-for-docs/Thu, 13 Aug 2026 00:00:00 GMTÜber Dokumentation zu lesen hilft, aber Fähigkeiten wachsen schneller durch wiederholte kleine Übungen zu Recherche, Struktur, Editing und Verification mit klarem Feedback. „Besser im Technical Writing werden“ ist zu breit.https://techwriters.org/de/articles/diagrams-as-code-in-documentation/https://techwriters.org/de/articles/diagrams-as-code-in-documentation/Thu, 13 Aug 2026 00:00:00 GMTEin praktischer und prüfbarer Ansatz für „Diagramme als Code: wann sie helfen und wann nicht“, der langfristig wartbare Dokumentation unterstützt. „Diagramme als Code: wann sie helfen und wann nicht“ mit einem praktischen, prüfbaren und wartbaren Ansatz für technische Dokumentation.https://techwriters.org/de/articles/docs-as-code-without-fanaticism/https://techwriters.org/de/articles/docs-as-code-without-fanaticism/Thu, 13 Aug 2026 00:00:00 GMTDocs-as-Code bedeutet nicht, alle Schreibenden in eine IDE zu zwingen. Entscheidend sind versionierte Quellen, einfache Browser-Bearbeitung, nützliche automatische Checks, sinnvolles Review und eine messbar bessere Veröffentlichung.https://techwriters.org/de/articles/docs-tools-then-and-now/https://techwriters.org/de/articles/docs-tools-then-and-now/Thu, 13 Aug 2026 00:00:00 GMTFormate und Publishing Pipelines haben sich stark verändert, die langlebigen Probleme sind vertraut: Source Control, Reuse, Navigation, Review und Synchronisierung mit dem Produkt. Lange bevor Docs-as-Code ein Begriff war, kämpften Teams mit mehreren Source Files, wiederverwendeten Fragmenten, Versionen und der Frage, welche Kopie aktuell ist.https://techwriters.org/de/articles/documentation-debt-triage/https://techwriters.org/de/articles/documentation-debt-triage/Thu, 13 Aug 2026 00:00:00 GMTEin praktischer und prüfbarer Ansatz für „Dokumentationsschulden: Was Nutzern wirklich schadet“, der langfristig wartbare Dokumentation unterstützt. „Dokumentationsschulden: Was Nutzern wirklich schadet“ mit einem praktischen, prüfbaren und wartbaren Ansatz für technische Dokumentation.https://techwriters.org/de/articles/documentation-in-ci-cd/https://techwriters.org/de/articles/documentation-in-ci-cd/Thu, 13 Aug 2026 00:00:00 GMTDokumentation 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.https://techwriters.org/de/articles/documentation-lead-without-bureaucracy/https://techwriters.org/de/articles/documentation-lead-without-bureaucracy/Thu, 13 Aug 2026 00:00:00 GMTEin Documentation Lead sollte Unsicherheit reduzieren statt eine zusätzliche Freigabestufe zu schaffen. Definiere Ownership, Standards und Eskalation, während Routine-Publishing schnell und nah am Produkt bleibt. Sobald Dokumentation über mehrere Teams verteilt ist, entsteht der Wunsch nach zentraler Kontrolle.https://techwriters.org/de/articles/documentation-metrics-that-matter/https://techwriters.org/de/articles/documentation-metrics-that-matter/Thu, 13 Aug 2026 00:00:00 GMTEin praktischer und prüfbarer Ansatz für „Dokumentationsmetriken, die mehr aussagen als Seitenaufrufe“, der langfristig wartbare Dokumentation unterstützt. „Dokumentationsmetriken, die mehr aussagen als Seitenaufrufe“ mit einem praktischen, prüfbaren und wartbaren Ansatz für technische Dokumentation.https://techwriters.org/de/articles/documentation-ownership-map/https://techwriters.org/de/articles/documentation-ownership-map/Thu, 13 Aug 2026 00:00:00 GMTEin praktischer und prüfbarer Ansatz für „Eine Ownership-Karte für Dokumentation ohne Bürokratie“, der langfristig wartbare Dokumentation unterstützt. „Eine Ownership-Karte für Dokumentation ohne Bürokratie“ mit einem praktischen, prüfbaren und wartbaren Ansatz für technische Dokumentation.https://techwriters.org/de/articles/documentation-review-workflow/https://techwriters.org/de/articles/documentation-review-workflow/Thu, 13 Aug 2026 00:00:00 GMTEin guter Review-Prozess macht Verantwortung sichtbar, verkürzt Wartezeiten und trennt fachliche, redaktionelle und produktseitige Prüfung. Autor, fachlichen Reviewer, Redaktion und finalen Owner definieren.https://techwriters.org/de/articles/documenting-api-errors/https://techwriters.org/de/articles/documenting-api-errors/Thu, 13 Aug 2026 00:00:00 GMTEin praktischer und prüfbarer Ansatz für „API-Fehler so dokumentieren, dass Entwickler reagieren können“, der langfristig wartbare Dokumentation unterstützt. „API-Fehler so dokumentieren, dass Entwickler reagieren können“ mit einem praktischen, prüfbaren und wartbaren Ansatz für technische Dokumentation.https://techwriters.org/de/articles/documenting-rest-api/https://techwriters.org/de/articles/documenting-rest-api/Thu, 13 Aug 2026 00:00:00 GMTGute API-Dokumentation verbindet maschinenlesbare Verträge mit Erklärungen, ausführbaren Beispielen und klar beschriebenem Fehlerverhalten. REST-API-Dokumentation hat zwei Zielgruppen: Maschinen und Menschen.https://techwriters.org/de/articles/editing-drills-for-technical-writers/https://techwriters.org/de/articles/editing-drills-for-technical-writers/Thu, 13 Aug 2026 00:00:00 GMTEin praktischer und prüfbarer Ansatz für „Redaktionsübungen, die technisches Schreiben schneller verbessern“, der langfristig wartbare Dokumentation unterstützt. „Redaktionsübungen, die technisches Schreiben schneller verbessern“ mit einem praktischen, prüfbaren und wartbaren Ansatz für technische Dokumentation.https://techwriters.org/de/articles/entering-technical-writing/https://techwriters.org/de/articles/entering-technical-writing/Thu, 13 Aug 2026 00:00:00 GMTVor drei Jahren konnten klare Sprache, einige Werkzeuge und ein Portfolio für den Einstieg reichen. 2026 ist die Hürde höher: KI erzeugt Entwürfe, Teams sind kleiner und von Technical Writers werden Faktenprüfung, API-Verständnis, Git und Verantwortung für das Dokumentationssystem erwartet.https://techwriters.org/de/articles/first-90-days-in-documentation-team/https://techwriters.org/de/articles/first-90-days-in-documentation-team/Thu, 13 Aug 2026 00:00:00 GMTEin praktischer und prüfbarer Ansatz für „Die ersten 90 Tage in einem Dokumentationsteam“, der langfristig wartbare Dokumentation unterstützt. „Die ersten 90 Tage in einem Dokumentationsteam“ mit einem praktischen, prüfbaren und wartbaren Ansatz für technische Dokumentation.https://techwriters.org/de/articles/forum-questions-that-aged-well/https://techwriters.org/de/articles/forum-questions-that-aged-well/Thu, 13 Aug 2026 00:00:00 GMTTool-Namen ändern sich schneller als redaktionelle Probleme. Ownership, Terminologie, Screenshots, Reuse und Review tauchen immer wieder auf, weil sie tiefere Systementscheidungen widerspiegeln. Die technische Antwort wechselte von Shared Folders zu Repositories und Ownership Rules.https://techwriters.org/de/articles/glossaries-and-terminology/https://techwriters.org/de/articles/glossaries-and-terminology/Thu, 13 Aug 2026 00:00:00 GMTEin Glossar wird nützlich, wenn es Entscheidungen in Produkt, Interface und Dokumentation steuert statt nur Wörter zu sammeln. Ein guter Eintrag enthält bevorzugten Begriff, Definition, verbotene oder veraltete Varianten, Kontext und Owner.https://techwriters.org/de/articles/hiring-technical-writers-without-trick-tests/https://techwriters.org/de/articles/hiring-technical-writers-without-trick-tests/Thu, 13 Aug 2026 00:00:00 GMTEin praktischer und prüfbarer Ansatz für „Technische Redakteure ohne Tricktests einstellen“, der langfristig wartbare Dokumentation unterstützt. „Technische Redakteure ohne Tricktests einstellen“ mit einem praktischen, prüfbaren und wartbaren Ansatz für technische Dokumentation.https://techwriters.org/de/articles/hypertext-before-modern-docs-portals/https://techwriters.org/de/articles/hypertext-before-modern-docs-portals/Thu, 13 Aug 2026 00:00:00 GMTEin praktischer und prüfbarer Ansatz für „Hypertext vor modernen Dokumentationsportalen“, der langfristig wartbare Dokumentation unterstützt. „Hypertext vor modernen Dokumentationsportalen“ mit einem praktischen, prüfbaren und wartbaren Ansatz für technische Dokumentation.https://techwriters.org/de/articles/information-architecture-for-growing-docs/https://techwriters.org/de/articles/information-architecture-for-growing-docs/Thu, 13 Aug 2026 00:00:00 GMTEine Struktur, die bei fünfzig Seiten funktioniert, kann bei fünfhundert scheitern. Navigation sollte sich an Nutzeraufgaben, Inhaltstypen und stabilen Konzepten orientieren — nicht am Organigramm. Kleine Dokumentationsbestände überleben fast jede Navigation.https://techwriters.org/de/articles/learn-api-docs-by-building-a-small-api/https://techwriters.org/de/articles/learn-api-docs-by-building-a-small-api/Thu, 13 Aug 2026 00:00:00 GMTEin praktischer und prüfbarer Ansatz für „API-Dokumentation mit einer kleinen eigenen API lernen“, der langfristig wartbare Dokumentation unterstützt. „API-Dokumentation mit einer kleinen eigenen API lernen“ mit einem praktischen, prüfbaren und wartbaren Ansatz für technische Dokumentation.https://techwriters.org/de/articles/llm-content-pipeline-guardrails/https://techwriters.org/de/articles/llm-content-pipeline-guardrails/Thu, 13 Aug 2026 00:00:00 GMTWenn ein Modell Content in großem Maßstab erstellt oder ändert, muss Validation mitskalieren. Begrenze Inputs, bewahre Provenance, validiere Struktur und trenne Generation von privilegiertem Publishing. Eine gute Architektur nimmt an, dass das Modell manchmal falsch liegt.https://techwriters.org/de/articles/markdown-at-scale/https://techwriters.org/de/articles/markdown-at-scale/Thu, 13 Aug 2026 00:00:00 GMTEin praktischer und prüfbarer Ansatz für „Markdown im großen Maßstab: Regeln gegen Repository-Chaos“, der langfristig wartbare Dokumentation unterstützt. „Markdown im großen Maßstab: Regeln gegen Repository-Chaos“ mit einem praktischen, prüfbaren und wartbaren Ansatz für technische Dokumentation.https://techwriters.org/de/articles/openapi-as-source-not-documentation/https://techwriters.org/de/articles/openapi-as-source-not-documentation/Thu, 13 Aug 2026 00:00:00 GMTEine OpenAPI-Beschreibung kann eine präzise Reference erzeugen. Developers brauchen zusätzlich Konzepte, Task Flows, Authentifizierung, Beispiele und Recovery, die ein Schema allein nicht erklärt. OpenAPI beschreibt Operations, Parameter, Request- und Response-Strukturen, Status Codes und wiederverwendbare Schemas sehr gut.https://techwriters.org/de/articles/portfolio-for-technical-writer/https://techwriters.org/de/articles/portfolio-for-technical-writer/Thu, 13 Aug 2026 00:00:00 GMTHiring Teams brauchen Evidenz dafür, wie du recherchierst, strukturierst und verifizierst. Ein starkes Portfolio erklärt Problem, Constraints, Prozess und Ergebnis statt nur polierte Screenshots zu zeigen. Ein polierter Artikel zeigt, dass du polierten Text schreiben kannst.https://techwriters.org/de/articles/release-notes-users-can-act-on/https://techwriters.org/de/articles/release-notes-users-can-act-on/Thu, 13 Aug 2026 00:00:00 GMTEin praktischer und prüfbarer Ansatz für „Release Notes, aus denen Nutzer konkrete Schritte ableiten können“, der langfristig wartbare Dokumentation unterstützt. „Release Notes, aus denen Nutzer konkrete Schritte ableiten können“ mit einem praktischen, prüfbaren und wartbaren Ansatz für technische Dokumentation.https://techwriters.org/de/articles/structured-writing-rules-that-scale/https://techwriters.org/de/articles/structured-writing-rules-that-scale/Thu, 13 Aug 2026 00:00:00 GMTKonsistenz im großen Maßstab entsteht durch Content Models, Terminologie und wiederverwendbare Patterns — nicht dadurch, dass alle einen riesigen Style Guide auswendig lernen. Wichtige Regeln gehören in Schemas und Components. Ein kleines Team kann auf gemeinsame Gewohnheiten und direktes Editing vertrauen.https://techwriters.org/de/articles/style-guide-people-use/https://techwriters.org/de/articles/style-guide-people-use/Thu, 13 Aug 2026 00:00:00 GMTEin praktischer und prüfbarer Ansatz für „Ein Styleguide, den Menschen tatsächlich benutzen“, der langfristig wartbare Dokumentation unterstützt. „Ein Styleguide, den Menschen tatsächlich benutzen“ mit einem praktischen, prüfbaren und wartbaren Ansatz für technische Dokumentation.https://techwriters.org/de/articles/synthetic-examples-and-hallucinations/https://techwriters.org/de/articles/synthetic-examples-and-hallucinations/Thu, 13 Aug 2026 00:00:00 GMTEin praktischer und prüfbarer Ansatz für „Synthetische Beispiele: nützlicher Entwurf, gefährlicher Beleg“, der langfristig wartbare Dokumentation unterstützt. „Synthetische Beispiele: nützlicher Entwurf, gefährlicher Beleg“ mit einem praktischen, prüfbaren und wartbaren Ansatz für technische Dokumentation.https://techwriters.org/de/articles/technical-writer-2006/https://techwriters.org/de/articles/technical-writer-2006/Thu, 13 Aug 2026 00:00:00 GMTDie Werkzeuge haben sich radikal verändert, doch der Kern bleibt erstaunlich vertraut: Zielgruppe, Belege, Struktur, Terminologie und Verantwortung. 2006 waren Desktop-Publishing, Office-Formate und manuell gepflegte Hilfesysteme wesentlich verbreiteter.https://techwriters.org/de/articles/technical-writer-skills-matrix/https://techwriters.org/de/articles/technical-writer-skills-matrix/Thu, 13 Aug 2026 00:00:00 GMTEine gute Matrix unterstützt Entwicklung und Hiring. Eine schlechte macht aus vagen Eigenschaften scheinpräzise Zahlen. Bewerte beobachtbare Fähigkeiten und die Komplexität der Dokumentationsprobleme, die jemand übernehmen kann. Teams bauen Kompetenzmatrizen oft dann, wenn Hiring inkonsistent oder Beförderungen subjektiv werden.https://techwriters.org/de/articles/vale-style-linting/https://techwriters.org/de/articles/vale-style-linting/Thu, 13 Aug 2026 00:00:00 GMTStyle 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.https://techwriters.org/de/articles/wcag-22-for-documentation/https://techwriters.org/de/articles/wcag-22-for-documentation/Thu, 13 Aug 2026 00:00:00 GMTAccessibility ist nicht nur Frontend-Arbeit. Autoren bestimmen Heading-Struktur, Linkzweck, Alt Text, Tabellen, Anweisungen und die Semantik, auf die assistive Technologien angewiesen sind. Ein Theme kann guten Kontrast und Keyboard-Verhalten liefern, aber Autoren entscheiden weiterhin über Verständlichkeit.https://techwriters.org/de/articles/when-manuals-shipped-on-cd/https://techwriters.org/de/articles/when-manuals-shipped-on-cd/Thu, 13 Aug 2026 00:00:00 GMTEin praktischer und prüfbarer Ansatz für „Als Handbücher noch auf CD ausgeliefert wurden“, der langfristig wartbare Dokumentation unterstützt. „Als Handbücher noch auf CD ausgeliefert wurden“ mit einem praktischen, prüfbaren und wartbaren Ansatz für technische Dokumentation.https://techwriters.org/de/articles/working-with-subject-matter-experts/https://techwriters.org/de/articles/working-with-subject-matter-experts/Thu, 13 Aug 2026 00:00:00 GMTEin praktischer und prüfbarer Ansatz für „Mit Fachexperten arbeiten, ohne jedes Review zum Meeting zu machen“, der langfristig wartbare Dokumentation unterstützt. „Mit Fachexperten arbeiten, ohne jedes Review zum Meeting zu machen“ mit einem praktischen, prüfbaren und wartbaren Ansatz für technische Dokumentation.