Everyone wishes that great docs for internal services were the norm, but few people are willing to spend the time to make these docs a reality.
Even if you do write good docs, they get lost in the ether of Confluence or Google Drive, never to be seen again by another human.
Motivated teams create dedicated websites for the software they have lovingly crafted. But searching for internal software isn’t like searching the open web. Google doesn’t index internal websites (hopefully!)
It’s no wonder that software teams struggle to find the motivation to produce great docs.
This is the problem that Backstage has begun to address this week, with the release of the Backstage TechDocs plugin.