Markdown, Asciidoc, or reStructuredText - a tale of docs-as-

Markdown, Asciidoc, or reStructuredText - a tale of docs-as-code

Who writes the developer documentation for your product? During the early days of my tech career, I worked on a database replication product at IBM. My immediate team had developers and testers but not a single technical writer. I can speak for myself when I say that I never bothered to know who keeps writing the lengthy and complex documentation for every release. Since then, many companies in tech (including companies like IBM) have taken a modern approach to documentation. This “modernization” started when more and more developers started writing documentation (not all developers hate writing docs ��). Having git running in their DNA, these developers wanted to bring in collaboration, version control, scripting, and easier bug tracking within developer documentation.

Related Keywords

Golang Hugo , Eric Holscher , John Gruber , Youtube , Twitter , Ibm , Gruber Markdown , Github Flavored Markdown , Github Flavored Asciidoc , Font Awesome , Although Asciidoctor ,

© 2025 Vimarsana