What Is Docs as Code?
Docs as Code is an approach to documentation where it is written, reviewed, versioned, and published using methods similar to software development.
Docs for people since 2007 | The complex simply
Docs for people since 2007 | The complex simply
Docs as Code is an approach to documentation where it is written, reviewed, versioned, and published using methods similar to software development.
When teams move technical documentation into Git, one of the first practical questions is deceptively simple: What format should we write in?
When a software team says, “Our documentation is missing,” the problem usually sounds simple: there is not enough written down. So the obvious solution seems to be: write more documentation. But in many teams, the real problem is not that the documentation…
Docs-as-code isn’t about turning writers into developers. It’s about giving them the tools to work smarter, collaborate better, and build scalable documentation. Yes, Git and AsciiDoc have a learning curve, but with the right support, they become empowering, not intimidating.
When we think about improving user experience, we often picture UX designers refining screens, flows, and visuals. But the truth is, some of the most painful UX issues aren’t visual at all. They’re structural.
You’ve heard of tech debt — those quick fixes and rushed decisions that come back to bite later. But there’s a quieter version of the same problem that can hurt your product just as badly: documentation debt.
(Yes, Already) When Maya and her co-founder launched their dev tool startup, they had one priority: build fast. They were doing all the right things. Ship quickly. Collect feedback. Stay lean.But after their launch, a pattern emerged.
While working for Applifting, I organized another Technical Writers’ Workshop in collaboration with CZ.NIC and Vendula. I presented on the topic of “Levelling The Czech Playing Fields” in Technical Writing. Presented in English with Czech material included in the video.
And in the following fest, I made it to the “Track I”! With the presentation called “Documenting SW according to its lifecycle”. In Czech only.
Remembering my past accomplishments, I have to share my presentation for InstallFest 2018 called “How to start documenting”. In Czech only.