https://platformengineering.org logo
#documentation
Title
# documentation
g

Greg Thomson

02/27/2023, 10:45 PM
What is the modern stack for internal engineering documentation - currently we have multiple teams storing knowledge in Notion but this is scattered and inconsistent What solutions have you found effective?
h

Hugo Pinheiro

02/27/2023, 11:48 PM
We use confluence but https://docusaurus.io/ and https://www.mkdocs.org/ are pretty good especially when coupled with a ci/cd pipeline
d

Daniel Serodio

02/28/2023, 11:05 PM
If you're already an Atlassian shop I'd go with Confluence. Otherwise, Docusaurus looks awesome.
a

Anto Masucci

03/07/2023, 10:56 AM
I recommend docusaurus for technical Documentation. I love the versioning feature so you can version the entire documentation for a platform. With a bit of automation (and process) you can scrape all the repos in your org for
/docs/*.md
to collate everything in a single place but keeping the source of truth in the repo.
m

Martin Iluminatti

05/13/2023, 6:49 PM
Hey @Hugo Pinheiro - we ended up combining the best of both worlds - we are currently using confluence, but we made a little custom code to allow the pipeline to publish in confluence as it if were docs as code
h

Hugo Pinheiro

05/13/2023, 6:50 PM
Ooh that's interesting
m

Martin Iluminatti

05/13/2023, 6:51 PM
Yeah 100% recommended - worth the little investment
h

Hugo Pinheiro

05/13/2023, 6:52 PM
💯
89 Views