Earlier quoted context omitted.
Every engineer I met dislikes Confluence. Engineers who write most of the documentation don't like using Confluence which lead to out dated, subpar and incomplete documentation. In my org, I noticed this and created a github repo to push documentation in Markdown. I created initial version of docs and now every engineer in our team uses it because they know markdown, appreciate version controlled docs and can use wha…
> Confluence which lead to out dated, subpar and incomplete documentation. How exactly is it Confluence's fault if your team does not update the docs?
I wouldn't be surprised to learn that many folks when faced with the prospect of updating a document using the Confluence editor will instead just find something less terrible to do.
I often write my entire document first using the old style Confluence markdown, and when done I import it into a new Confluence page. You can't take an existing document and convert into markdown, but if you are the only person working on the document this is a workable approach.