DEV Community

Discussion on: Where do you keep non-code documentation, such as architecture explanation or research?

Collapse
 
sstubblefield profile image
Scott Stubblefield

Following. I've helped initiate a new set of docs at my company over the last couple of weeks, and we're currently in this dilemma. We were using Confluence to keep important info, but it just feels so detached from our workflow. We've started including a more informationally verbose readme in our project files, and eventually decided to build our docs in ButBucket. I don't know if it will stay that way, as we're still discussing whether or not the Project Managers should learn Markdown and the basics of Git, in order to maintain docs from their end. I'd love to eventually see a better solution, such as a front end wysiwig that converts rich text into MD, and ties into a repo.