https://platformengineering.org logo
#platform-design
Title
# platform-design
s

Stefan Kolesnikowicz

06/09/2022, 10:50 AM
Me too me too! Happy #platformcon day! I am also around to answer any questions people maybe have to my talk regarding the developer experience and how Achievers solved problems for our engineers (specifically around 10+ years of old documentation). I will be around most of the day to respond to questions platformcon platformcon platformcon

https://youtu.be/aESVbriWgaw

👋 1
👏 4
l

Luca Galante

06/09/2022, 10:50 AM
Happy platformcon day!! 😄
❤️ 1
a

Alejandro Vélez-Calderón

06/09/2022, 1:14 PM
great job Stefan! curious if you’ve heard of https://backstage.io/ and if you considered that vs docusaurus?
d

Daniel Friman

06/09/2022, 1:29 PM
@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?
s

Stefan Kolesnikowicz

06/09/2022, 1:33 PM
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
d

Daniel Friman

06/09/2022, 2:06 PM
Thanks for the link!
a

Anthony Critelli

06/09/2022, 6:22 PM
@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).
👍 1
s

Stefan Kolesnikowicz

06/09/2022, 6:23 PM
great thanks so much @Anthony Critelli - i will check it out!
m

Mitesh Sharma

06/11/2022, 11:02 AM
@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?
s

Stefan Kolesnikowicz

06/11/2022, 12:09 PM
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
👍 1
29 Views