See the README for licensing and legal information.
- Fixes to incorrect statements or inaccuracies within the documentation.
- Rewording or extending documentation to clarify unclear wording or complicated explanations.
- Additions that fill gaps or missing pieces in the current documentation.
- Fixing of spelling and grammatical errors in the documentation.
- Whitespace or formatting changes.
- Subjective wording changes.
- Modifications to the overall structure and format of the API docs.
- Additions that replicate or needlessly restructure current documentation.
- Additions that document unreleased product functionality.
- Changes that modify Community Resources (see guidelines for more detail).
This repository uses special markdown syntax that helps style the resulting web version of the documentation.
H6 headings should be used above tables and code blocks to properly label them.
Links between docs can be achieved by using a hash symbol (#), plus the markdown file name, plus a slash, and finally the dash-separated anchor. For instance, to link to the above H6 heading section:
[Links to README.md H6](#README/h6-headings)Alert boxes are created using a block quote that has one of 'warn', 'danger', 'info', or 'preview' on the first line.
There are a few reusable MDX components that can be used on pages with the mdx extension.
Collapsibles allow you to show/hide content on a page that may be secondary to the page's primary content. They have four fields that can be set: title, description, icon, and an open flag (which makes the collapsible element open by default).
Available options for icon are "list", "view", "question", and "code".
<Collapsible title="Title" description="Description text" icon="list">
Collapsed content
</Collapsible>Buttons are simply... clickable buttons. They take href and color as arguments, but currently we only use "brand" as a value for color.
<Button href="https://discord.com/developers/docs/getting-started" color="brand">click the button!</Button>Cards let you display links in a card format. They accept two arguments, title and link.
<Card title="Card Title" link="https://discord.com/developers/docs/getting-started">
This is the content inside of the card~
</Card>