# Contributing

See the [README](https://github.com/discord/discord-api-docs/blob/main/README.md) for licensing and legal information.

## Types of Changes

### Wanted Changes

1. Fixes to incorrect statements or inaccuracies within the documentation.
1. Rewording or extending documentation to clarify unclear wording or complicated explanations.
1. Additions that fill gaps or missing pieces in the current documentation.
1. Fixing of spelling and grammatical errors in the documentation.

### Unwanted Changes

1. Whitespace or formatting changes.
1. Subjective wording changes.
1. Modifications to the overall structure and format of the API docs.
1. Additions that replicate or needlessly restructure current documentation.
1. Additions that document unreleased product functionality.
1. Changes that modify [Community Resources](https://discord.com/developers/docs/topics/community-resources#community-resources) (see [guidelines](https://github.com/discord/discord-api-docs/discussions/4456) for more detail).

## Markdown Syntax

Our documentation uses standard [Markdown](https://www.markdownguide.org/basic-syntax/) syntax with some additional [MDX](https://mdxjs.com/) features.

We also support the following formatting from Mintlify:

- [Format Text](https://www.mintlify.com/docs/create/text)
- [Format Code](https://www.mintlify.com/docs/create/code)
- [Images & Embeds](https://www.mintlify.com/docs/create/image-embeds)
- [Files](https://www.mintlify.com/docs/create/files)
- [Lists & Tables](https://www.mintlify.com/docs/create/list-table)
- [Available Components](https://www.mintlify.com/docs/components/accordions)