Our great sponsors
-
WorkOS
The modern identity platform for B2B SaaS. The APIs are flexible and easy-to-use, supporting authentication, user identity, and complex enterprise features like SSO and SCIM provisioning.
-
Asciidoctor
:gem: A fast, open source text processor and publishing toolchain, written in Ruby, for converting AsciiDoc content to HTML 5, DocBook 5, and other formats.
have you tried tools like https://github.com/duo-labs/markdown-to-confluence so you can have best of both worlds?
Public docs, exploring https://docusaurus.io which is also markdown and mdx for interactive stuff
Its nowhere near perfect but we maintain a Standards and Practice repo here: https://github.com/Shift3/standards-and-practices works well when people get onboarded and have questions regarding what our standards are.
We use Antora and Asciidoc, published as in Gitlab pages, for technical documentation.
I built a system for this in my last workplace, albeit for a company-wide (Mixed skill) use-case. Have continued to develop it for almost 7 years. Here's the site for it: https://www.bookstackapp.com
We use Wiki.js and it has been perfect for our use case.