diff --git a/website/docs/Contributing.mdx b/website/docs/Contributing.mdx index 55c7a0f6..611c9066 100644 --- a/website/docs/Contributing.mdx +++ b/website/docs/Contributing.mdx @@ -48,7 +48,8 @@ document can be used by bots and are _intended_ for usage by bots. This is a har Not every single update to the API is valid to be documented here. Our main stance for documentation is that properties must be known and documented on [`Discord's API Documentation repository`](https://github.com/discord/discord-api-docs), -must be mentioned in an open pull request or must have received the green light to be used. +must be mentioned in an open pull request, must have received the green light to be used, or must be present in the +[stable OpenAPI specification](https://github.com/discord/discord-api-spec/blob/main/specs/openapi.json). With that aside, there are times where documentation for certain types is not approved/merged by Discord on the grounds that `it isn't helpful for bots` (or similar), but it would actually benefit bot developers to have it documented (one