4 ms·
Ask HN: Confluence Alternative(s) Supporting Markdown?
A SaaS is fine if they integrate with Okta SSO, otherwise something open source that we can self host would be the backup. But this is definitely a `Build < Buy` situation I'm in.
Luckily outside of engineering they don't use our confluence. So the target audience is technical.
Any advice here or questions are welcomed. Thank you.
- jrudolph 4y agonotion.so, also has integrated support for mermaid diagrams, decent syntax highlighting etc.
- quickthrower2 4y agoWhat is your pain point with Confluence?
- joshSzep 4y agoIt's developer hostile
- techplex 4y agoLots of options in Awesome SelfHosted: https://github.com/awesome-selfhosted/awesome-selfhosted#wikis https://github.com/awesome-selfhosted/awesome-selfhosted#wik... Checkout Bookstack https://www.bookstackapp.com/ https://www.bookstackapp.com/
- nivertech 4y agoIMO wikis are anti-pattern. They always getting out of sync and eventually abandoned. Just store markdown files under the /docs/ folder in the git repo.
- joshSzep 4y agoWould you do the same with onboarding docs, system design docs, meeting notes, etc?
- nivertech 4y ago> onboarding docs yes, if they're don't change frequently by non-technical people. There are tools allowing conversion between GDocs and markdown. So one can start with the GDoc at the initial non-tech collaboration stage, and once it's more or less stabilized, convert it to markdown and commit to a git repo. > system design docs yes - see C4-PlantUML[1] > meeting notes no, unless they're directly code related like ADRs [2,3]. Although, one can abuse Github Issues + comments for this, in my opinion it's better to use modern SaaS tools in this case, e.g. Loom, Descript, otter/gong, etc. - you can automate this process, e.g. transcribe the meeting's recording and add the issue/repo using Github Actions. > etc. To summarize: any piece of documentation/diagrams that has even minimal affinity to the source code and can be expressed in a text-based format. I even store visual non-text based diagrams (non-manually editable XML) using Draw.io VSCode extension [4], or Miro board backups/dumps. Use linters and automate with CI/CD (e.g. Github Actions). Also I suggest to have a list of VSCode extensions for each text/diagramming format used in the repo. Maybe with the script to automate their installation. -- [1] https://github.com/plantuml-stdlib/C4-PlantUML https://github.com/plantuml-stdlib/C4-PlantUML [2] https://adr.github.io/ https://adr.github.io/ [3] https://docs.aws.amazon.com/prescriptive-guidance/latest/architectural-decision-records/adr-process.html https://docs.aws.amazon.com/prescriptive-guidance/latest/arc... [4] https://marketplace.visualstudio.com/items?itemName=hediet.vscode-drawio https://marketplace.visualstudio.com/items?itemName=hediet.v...
- joshSzep 4y ago> To summarize: any piece of documentation/diagrams that has even minimal affinity to the source code and can be expressed in a text-based format. You have me sold, friend.
- rozenmd 4y agoGoogle Docs support markdown, though significantly worse UX than Confluence (cloud)