Here are a few examples of API breaking change policies. 1. LinkedIn API Breaking Change Policy 2. Microsoft Graph API Breaking Change Policy 3. HubSpot API Breaking Changes 4. Stripe API Upgrades 5. Twitter Versioning
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.