Skip to content

Latest commit

 

History

History
99 lines (65 loc) · 3.04 KB

CONTRIBUTING.md

File metadata and controls

99 lines (65 loc) · 3.04 KB

Contributing

See the README for licensing and legal information.

Types of Changes

Wanted Changes

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

Unwanted Changes

  1. Whitespace or formatting changes.
  2. Subjective wording changes.
  3. Modifications to the overall structure and format of the API docs.
  4. Additions that replicate or needlessly restructure current documentation.
  5. Additions that document unreleased product functionality.
  6. Changes that modify Community Resources (see guidelines for more detail).

Markdown Syntax

This repository uses special markdown syntax that helps style the resulting web version of the documentation.

H6 Headings

H6 headings should be used above tables and code blocks to properly label them.

Linking

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

Alert boxes are created using a block quote that has one of 'warn', 'danger', 'info', or 'preview' on the first line. For example:

> warn
> Something that requires warning here

Alert options

MDX Components

There are a few reusable MDX components that can be used on pages with the mdx extension.

Collapsibles

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:

  • "list"
  • "view"
  • "question"
  • "code"
  • "warning"
Example

Collapsible MDX Component with the list icon

<Collapsible title="Title" description="Description text" icon="list">
Collapsed content
</Collapsible>

Buttons

Buttons are simply... clickable buttons. They take href and color as arguments, but currently we only use "brand" as a value for color.

Example

Button MDX Component

<Button href="https://discord.com/developers/docs/getting-started" color="brand">click the button!</Button>

Cards

Cards let you display links in a card format. They accept two arguments, title and link.

Example

Card MDX Component

<Card title="Card Title" link="https://discord.com/developers/docs/getting-started">
This is the content inside of the card~
</Card>