“There is a secret that needs to be understood in order to write good software documentation: there isn’t one thing called documentation, there are four.”
Tutorials, how-to guides, reference and explanation. Most projects dump all four into one README and call it done. The tutorial wanders into edge cases and the reference tries to teach. Nobody can find anything. The fix is a filing system, and it costs nothing.