Tag
Docs-as-Code
4 articles
-
Why hand-maintained InDesign files rot - and what docs-as-code does instead
A 370-cell calendar that shifts every year. A lead's name in three places. An IBAN in an invisible text box. These are not unusual InDesign problems - they are what InDesign files become when they accumulate facts with no single home. Two projects show what the alternative looks like - and where InDesign's own global tools stop short.
-
Manage content in files, not databases
Databases are not always the best place for your content. By storing it in plain files, you gain speed, security, Git-based workflows, and a simpler, more reliable publishing stack.
-
Strong information typing without the XML overhead
You don’t need the complexity of DITA XML to benefit from its discipline. With Markdown and modern docs-as-code workflows, technical writers can apply strong information typing-tasks, concepts, and references-using lightweight, open tools.
-
A web journey: from HTML to Git-based Markdown workflows
Tracing over two decades of web publishing, from raw HTML and Dreamweaver to CMSes, structured content, static site generators, and modern Git-based Markdown workflows. Lessons for solo and team content developers on maintainability, collaboration, and performance.