Documentation best practices

I have been on a “change our team” rush this past year or so. My team previous used a CVS type source control and with customer desires and talking to other companies in our field, I finally got enough momentum to get the team on bitbucket/jira (I know it’s not the most popular duo, but that was my best bet).

What comes up now is documentation of our system, diagrams, etc. Previously we used the same system as our code, which was fine except hard to navigate. I created a onenote for ease of access notes that people used until it became just as hard to navigate.

So now I’m looking at alternative sources, what do yall do? How do yall make sure peer reviews of documentation is still happening? What is the best practices? What software suite do you use?