Markdown is a commonly used markup format used for blogs, documentation, and other longform content. It translates easily into HTML, and is easy for humans to read in its raw form. We use Markdown heavily at Doctave (since our product...

We’re incredibly excited to announce that Doctave’s developer documentation is publicly available. You can find it at https://docs.doctave.com. Our closed beta in Doctave since October 2022. So far all our documentation has been behind a password, meaning that only teams...

You probably like docs-as-code. What’s not to love? Technical writers can collaborate with developers via source control and Markdown-based static site generators are powerful and flexible publishing tools. This is in contrast to traditional XML-based publishing systems which make it...

If your software documentation lives in a Wiki, it’s very likely out of date and possibly actively harming your engineering team’s productivity. This is a story that repeats in almost every organization - a tool like Confluence or Notion is...

Many technical problems ultimately turn out to be people problems, and a lack of good documentation is no exception. Writing and maintaining documentation is a habit that needs to be encouraged and nurtured. The unfortunate truth is that no amount...

This post references an old version of Doctave You can read more about our new documentation platform here. We are excited to announce that Doctave.com is now in public beta. Doctave.com is the best place to host your docs-as-code documentation,...

The Agile Manifesto values “working software over comprehensive documentation”. This has led to some to believe that documentation has little value in a modern software development workflow - that’s a mistake. Let’s look at what role documentation can play in...