Github launched a revamp of their documentation site on July 2nd, 2020, and their launch blog post had lots of useful points.
- Versioning documentation is hard. It is well worth thinking about the the url structures ahead of time.
- Unlike GraphDoc, the GraphQL Docs tool they used allows linking to specific operations.