Take back control of your documentation
Docs-as-code gives you control of your content.
Iāve seen teams trapped by their documentation platform. Five years of content locked in a proprietary CMS. Export breaks formatting. No clean way out. Then the vendor changes pricing and thereās nothing you can do.
Your content stays in their system. Your build process depends on their infrastructure. Your ability to move depends on their export tool, which barely works.
Docs-as-code flips this. Content is markdown in Git. You own the build process. You can host anywhere. Switch tools without losing content.
This isnāt anti-SaaS (there are docs-as-code friendly platforms out there). Itās about keeping ownership of your content so it doesnāt become leverage for someone else.
Your docs are a business asset. Treat them like one.
P.S. Iām back on Substack with a weekly note on technical writing, docs-as-code, and automation. If youāre not interested, you can unsubscribe anytime.



Iām curious how youād go about this at an enterprise level. How do you handle variables, conditions, generating output like help sites and PDFs?