diff --git a/apps/guide/public/assets/discordjs.png b/apps/guide/public/assets/discordjs.png new file mode 100644 index 000000000..9294057b7 Binary files /dev/null and b/apps/guide/public/assets/discordjs.png differ diff --git a/apps/guide/src/content/02-requesting-more-content.mdx b/apps/guide/src/content/02-requesting-more-content.mdx deleted file mode 100644 index 5f910eb1e..000000000 --- a/apps/guide/src/content/02-requesting-more-content.mdx +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: Requesting more content -category: Home ---- - -# Requesting more content - -Since this guide is made specifically for the discord.js community, we want to be sure to provide the most relevant and up-to-date content. We will, of course, make additions to the current pages and add new ones as we see fit, but fulfilling requests is how we know we're providing content you all want the most. - -Requests may be as simple as "add an example to the [frequently asked questions](/popular-topics/faq.html) page", or as elaborate as "add a page regarding [sharding](/sharding/)". We'll do our best to fulfill all requests, as long as they're reasonable. - -To make a request, simply head over to [the repo's issue tracker](https://github.com/discordjs/guide/issues) and [create a new issue](https://github.com/discordjs/guide/issues/new)! Title it appropriately, and let us know exactly what you mean inside the issue description. Make sure that you've looked around the site before making a request; what you want to request might already exist! - - - Remember that you can always [fork the repo](https://github.com/discordjs/guide) and [make a pull - request](https://github.com/discordjs/guide/pulls) if you want to add anything to the guide yourself! - diff --git a/apps/guide/src/content/03-whats-new.mdx b/apps/guide/src/content/02-whats-new.mdx similarity index 100% rename from apps/guide/src/content/03-whats-new.mdx rename to apps/guide/src/content/02-whats-new.mdx diff --git a/apps/guide/src/content/03-how-to-contribute.mdx b/apps/guide/src/content/03-how-to-contribute.mdx new file mode 100644 index 000000000..281a6e084 --- /dev/null +++ b/apps/guide/src/content/03-how-to-contribute.mdx @@ -0,0 +1,177 @@ +--- +title: How to contribute +category: Home +--- + +# How to contribute + +Since this guide is made specifically for the discord.js community, we want to be sure to provide the most relevant and up-to-date content. We will, of course, make additions to the current pages and add new ones as we see fit, but fulfilling requests is how we know we're providing content you all want the most. + +Requests may be as simple as "add an example to the [frequently asked questions](/popular-topics/faq.html) page", or as elaborate as "add a page regarding [sharding](/sharding/)". We'll do our best to fulfill all requests, as long as they're reasonable. + +To make a request, simply head over to [the repository's issue tracker](https://github.com/discordjs/discord.js/issues) and [create a new issue](https://github.com/discordjs/discord.js/issues/new)! Title it appropriately, and let us know exactly what you mean inside the issue description. Make sure that you've looked around the site before making a request; what you want to request might already exist! + + + Remember that you can always [fork the repository](https://github.com/discordjs/discord.js/fork) and [make a pull + request](https://github.com/discordjs/discord.js/pulls) if you want to add anything to the guide yourself! + + +We'll also get into some of the more advanced features this guide does below. + +## Components + +Throughout the guide, you'll see some components from the _`@discordjs/ui`_ package: + +- _`Alert`_ +- _`Section`_ +- _`DiscordMessages`_, _`DiscordMessage`_, and _`DiscordMessageEmbed`_ + +Check the source of this page to see them in action! + +### Alert + +This component may take a _`title`_ and a _`type`_ of _`'danger' | 'info' | 'success' | 'warning'`_. + +This uses _`title="Alert" type="info"`_: + + + Use these appropriately! + + +### Section + +
+Well, hello there! + +Whenever some text does not need to be in the main body, you can put it here. + +- _`title`_: The title that'll appear. +- _`padding`_: Adds padding. + - _`dense`_: When _`padding`_ is specified, _`dense`_ could make it appear, well, dense. +- _`defaultClosed`_ Whether the section is closed by default. This one was. +- _`background`_ Adds background to the content. +- _`gutter`_: This adds a very small appealing space between the expansion of the section and its content. + +
+ +### DiscordMessages, DiscordMessage, and DiscordMessageEmbed + + + + A _`DiscordMessage`_ must be within _`DiscordMessages`_. + + + It's much better to see the source code of this page to replicate and learn! + + + This message depicts the use of embeds. + <> + + This is a description. You can put a description here. It must be descriptive! + + + Multiple embeds! + + + + + Interactions are supported! I definitely used a command. + + + +## Code blocks + +We use [Code Hike](https://codehike.org). Here are some example code blocks, which should be easy to grasp and learn upon reading the source code of this page: + + + +```ts +const HELLO = 'hello' as const; +console.log(HELLO); +// "ts" is the language of the code block. +``` + + + + + +```ts fileName +const FILE_NAME = 'fileName' as const; +if (FILE_NAME.includes(' ')) throw new Error('Spaces cannot be used in file names.'); +``` + +```ts anotherFileName +const FILE_NAME_2 = 'anotherFileName' as const; +// Putting code blocks together makes them appear in tabs, just like in your editor. +``` + +--- + +```ts requiredName +const FILE_NAME_3 = 'requiredName' as const; +if (!FILE_NAME) throw new Error('There must be a file name to use panels!'); +// The --- divider was used to create a panel. +``` + + + +For more information, be sure to check out the [documentation](https://codehike.org/docs/ch-code). diff --git a/apps/guide/src/content/04-test.mdx b/apps/guide/src/content/04-test.mdx deleted file mode 100644 index 2e0bb5fb7..000000000 --- a/apps/guide/src/content/04-test.mdx +++ /dev/null @@ -1,100 +0,0 @@ ---- -title: Test -category: Test ---- - - - - 1234 - - - 1234 - - - - - - 1234 - - - - - - <> - - - - - Test - - - -