Tag
Docs-as-code
3 articles
-
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.