This article is from 2015, but includes helpful guidance and tips for writing documentation for software projects. This comes from Rich Bowen, the Community Liaison for the RDO project, a packaging of OpenStack for CentOS/Fedora/RHEL.
Give it a read below: