jingo VS mark

I use jingo as a personal wiki. It uses markdown syntax and provides a simple online editing interface. Not sure how it scales but you can self host and it’s free. https://github.com/claudioc/jingo

Hadn't heard of this before, looks very cool. For anyone interested: https://github.com/claudioc/jingo

I use Jingo (https://github.com/claudioc/jingo). It's built with NodeJS, uses Markdown, and stores everything in a git repository automatically pushed to a remote repository (in my case Bitbucket). That way everything is in plain text and has full version history should I ever want to move to another system.

Readme.md should be the very first source of documentation. From there we may have a nested “docs” directory all written in markdown and then as part of CI we sync that all into confluence on merges to dev using https://github.com/kovetskiy/mark

We use Mark[1] to automatically create Confluence pages from Markdown documents in our git repos. So we can have a review process for documentation changes, the documentation of the code can be in the repo with the code, and yet it can still be accessed without having to give permissions to view the code repo! Helpful with a proprietary monorepo.

[1] https://github.com/kovetskiy/mark

I used https://github.com/kovetskiy/mark at my last job where I had to use Confluence. It wasn't perfect and some touchup was generally needed after a sync but it definitely helped me stay sane.

At the UAT/Production stage, the documentation is pushed to the Wiki using the extension of choice (most documentation parsers support the major wiki providers, like for Confluence there's Mark for Markdown, Official AsciiDoctor Exporter, and RST Exporter), or parsed into a DocBook/eBook/PDF for publishing.