This message was deleted.

Happy platformcon day!! 😄

great job Stefan! curious if you’ve heard of https://backstage.io/ and if you considered that vs docusaurus?

@Stefan Kolesnikowicz Thank you for the talk today. I recognize what you describe, and I think there are many of us in the same situation. I'm curious if you have more in-depth details on how you set up this and how much it was to get it running?

yes for sure! https://achievers.engineering/documentation-part-2-still-running-through-the-6-with-documentation-woes-ce84d6bbc5ea we wrote 2 blog articles with more information - if you have any followups let me know

Thanks for the link!

@Stefan Kolesnikowicz I enjoyed your talk, thanks for presenting it! Documentation (and technical writing, generally) is a topic that I really enjoy. If you haven't seen it, I'd really recommend this video and accompanying doc about a four part system for comprehensive documentation. It's the best thing I've found that matches my personal philosophy for writing high quality documentation (specifically for products, but those could be internal products, like a developer platform).

great thanks so much @Anthony Critelli - i will check it out!

@Stefan Kolesnikowicz Thanks a lot for this talk. It felt like you talked about pain we are having in our company. Do you guys store .md file in your code that get exported or some other way to do this?

Yes we do. Check out this blog post where we talk about it a bit more in detail https://achievers.engineering/documentation-part-2-still-running-through-the-6-with-documentation-woes-ce84d6bbc5ea We can then keep the code and documentation together but also push the md files somewhere else to search easier and display them in a central location. The source of truth is always the code repo