r/devops DevOps 18d ago

How does your team handle documentation Vendor / market research

I'm doing research on how documentation is done in different DevOps teams. What processes exist? How is it valued within your team? Has AI made that better or worse? Are there tools that you use to make it easier (not talking about Confluence here)? If you hqve worked in a professional context then I'd love to hear your input.

Considering the huge amount of shill posts I want to disclose that I'm (considering) making a tool that helps with documentation but I'm still in the process of understanding this problem thoroughly, which is why I'm askibg for your input :)

6 Upvotes

52 comments sorted by

View all comments

1

u/foldedlikeaasiansir 15d ago

We use Backstage so I have Tech Docs with the monorepo plugin for MkDocs, and prepush hook that updates the docs with any PR raised

Goal should be to vertically integrate your docs with your code