Writing documentation is different from writing code.
Source: Markdown, Asciidoc, or reStructuredText – a tale of docs-as-code – Dewan’s Blog
I’m currently using commonmark in vim to write my own personal documentation for things and keep running into that small issue of having to embed HTML if I want to do anything “complicated”. I’m also trying out keeping it in git… although this might be a bit of overkill.
All in all a great article on what things you need to consider if you need to implement documentation for an entire organization and you want that documentation versioned and actionable.
Yeah, git sucks, but there are other version control systems out there. Gotta mix and match.