diff --git a/README.md b/README.md index 2c89ef8..c670533 100644 --- a/README.md +++ b/README.md @@ -1,17 +1,70 @@ ---- -description: 'The unofficial Discord.js beginner''s guide, written by idiots for beginners.' ---- +
+

An Idiots Guide

+

Discord.JS Bot Guide

+

+ The unofficial Discord.JS beginner's guide, written by idiots, for beginners +

+
-# Welcome +Table of Contents +============== -## Introduction +- [Getting Started](https://anidiots.guide/getting-started/) + - [Long Version](https://anidiots.guide/getting-started/getting-started-long-version/) + - [TL;DR (short) Version](https://anidiots.guide/getting-started/getting-started-tl-dr/) -This guide makes a best effort attempt at humanizing the use of the Discord.js library, in its current version 13 iteration. It is maintained by York\#0001 and Discordaholic\#0001 \("Evie.Codes"\), with the help of many precious contributors that enable us to keep updating and enhancing this guide. +- [First Bot](https://anidiots.guide/first-bot/) + - [Your First Bot](https://anidiots.guide/first-bot/your-first-bot/) + - [Adding a Config File](https://anidiots.guide/first-bot/adding-a-config-file/) + - [Command with Arguments](https://anidiots.guide/first-bot/command-with-arguments/) + - [Basic Command Handler](https://anidiots.guide/first-bot/a-basic-command-handler/) + - [The BETTER Basic Command Handler](https://anidiots.guide/first-bot/better-basic-handler/) + - [Using Embeds in Messages](https://anidiots.guide/first-bot/using-embeds-in-messages/) -It was born out of necessity - the first version of this guide for Discord.js version 7, more than 5 years ago, was the first of its kind because I \(Evie\) could not find any such beginner's guide and the documentation was \(and still is\) unfathomably difficult to navigate for anyone without a sufficiently advanced knowledge of JavaScript concepts. +- [Coding Guides](https://anidiots.guide/coding-guides/) + - [SQLite-Based Points System](https://anidiots.guide/coding-guides/sqlite-based-points-system/) + - [Using Emojis](https://anidiots.guide/coding-guides/using-emojis/) + - [Making a Starboard](https://anidiots.guide/coding-guides/making-your-own-starboard/) + - [Tracking Used Invites](https://anidiots.guide/coding-guides/tracking-used-invites/) + - [Using Audit Logs](https://anidiots.guide/coding-guides/using-audit-logs/) -In this guide we make every effort to _teach_ you how to use the library and how to extend it with your own code. We do, however expect you to have a basic understanding of JavaScript before attempting to write bots. Discord.js \(and other discord libraries\) require some median-to-advanced concepts that might be hard to grasp for anyone that doesn't have a good footing with the language. +- [Understanding](https://anidiots.guide/understanding/) + - [Events and Handlers](https://anidiots.guide/understanding/events-and-handlers/) + - [Collections](https://anidiots.guide/understanding/collections/) + - [Roles & Permissions](https://anidiots.guide/understanding/roles/) + - [Sharding](https://anidiots.guide/understanding/sharding/) -## Get Support +- [Examples](https://anidiots.guide/examples/) + - [Making an "Eval" command](https://anidiots.guide/examples/making-an-eval-command/) + - [Misc. Examples](https://anidiots.guide/examples/miscellaneous-examples/) -If you have any questions after reading this guide, please don't hesitate to join us on our Discord server, "An Idiot's Guide". The link is located at the top of this page. If you wish to consult with the discord.js developers and official community, the Discord.js official discord is right next to ours, still at the top of the page! +- [Discord Webhooks](https://anidiots.guide/discord-webhooks/) + - [Webhooks (Part 1)](https://anidiots.guide/discord-webhooks/discord-webhooks-part-1/) + - [Webhooks (Part 2)](https://anidiots.guide/discord-webhooks/discord-webhooks-part-2/) + - [Webhooks (Part 3)](https://anidiots.guide/discord-webhooks/discord-webhooks-part-3/) + +- Video Guides *(coming.. soon™️)* + +- [Other Guides](https://anidiots.guide/other-guides/) + - [Installing and Using "Atom"](https://anidiots.guide/other-guides/installing-and-using-a-proper-editor/) + - [Using "Git" to Update and Share Code](https://anidiots.guide/other-guides/using-git-to-share-and-update-code/) + - [Using Environment Variables](https://anidiots.guide/other-guides/env-files/) + - [Async / Await](https://anidiots.guide/other-guides/async-await/) + + +Welcome! +======== + +## What even is this? + +This guide makes a best effort attempt at humanizing the use of the Discord.JS library, in its current version 13 iteration. It is maintained by York#0001 and Discordaholic#0001 *("Evie.Codes")*, with the help of many precious contributors that enable us to keep updating and enhancing this guide. + +## How did it start? + +It was born out of necessity - the first version of this guide for Discord.js version 7, more than 5 years ago, was the first of its kind because I *(Evie)* could not find any such beginner's guide and the documentation was *(and still is)* unfathomably difficult to navigate for anyone without a sufficiently advanced knowledge of JavaScript concepts. + +In this guide we make every effort to _teach_ you how to use the library and how to extend it with your own code. We do, however expect you to have a basic understanding of JavaScript before attempting to write bots. Discord.js *(and other discord libraries)* require some median-to-advanced concepts that might be hard to grasp for anyone that doesn't have a good footing with the language. + +## Need Support? + +If you have any questions after reading this guide, please don't hesitate to join us on our [Discord](https://discord.gg/vXVxsAjSMF) server, "An Idiot's Guide". If you wish to consult with the Discord.JS developers and official community, you can join their Discord [here](https://discord.gg/djs) diff --git a/coding-guides/README.md b/coding-guides/README.md index 212e8bc..5460b57 100644 --- a/coding-guides/README.md +++ b/coding-guides/README.md @@ -1 +1,4 @@ -# Coding Guides +Coding Guides +============= + +In this section, we are going to give you some guides on how to add even cooler things to your bot such as a point system, starboard system, and more! \ No newline at end of file diff --git a/discord-webhooks/README.md b/discord-webhooks/README.md index 298c42a..b6c3185 100644 --- a/discord-webhooks/README.md +++ b/discord-webhooks/README.md @@ -1,4 +1,6 @@ -# Discord Webhooks - +Discord Webhooks +================ +Now we're getting into the "cool zone" 😎 +In this section we will teach you everything you need to know about Discord and their cool-ass webhooks \ No newline at end of file diff --git a/examples/README.md b/examples/README.md index df635b4..eeb0bb5 100644 --- a/examples/README.md +++ b/examples/README.md @@ -1 +1,6 @@ -# Examples +Examples +======== + +Trust me, we know that sometimes getting that extra example or 2 will really help you. + +And that's exactly what this section is about! \ No newline at end of file diff --git a/first-bot/README.md b/first-bot/README.md index d3e43aa..72816f0 100644 --- a/first-bot/README.md +++ b/first-bot/README.md @@ -1 +1,6 @@ -# First Bot +First Bot +========= + +We've got you started! Awesome! + +Now we are going to get your first bot up and running that has: commands, handlers, and all of that cool-fun-stuff! \ No newline at end of file diff --git a/getting-started/README.md b/getting-started/README.md index 9bfeaec..aba5063 100644 --- a/getting-started/README.md +++ b/getting-started/README.md @@ -1,3 +1,8 @@ -# Getting Started +Getting Started! +================ -In this section we will teach you how to get started in the world of bot development! +You've finally decided to give in and start developing Discord bots and ditching bots like *"MEE6"* and *"Dyno"* + +We promise, you've made the good decision. + +In this section we are going to get you started in the world of Discord Bot Development! \ No newline at end of file diff --git a/other-guides/README.md b/other-guides/README.md index 818eba0..eed5fa0 100644 --- a/other-guides/README.md +++ b/other-guides/README.md @@ -1,4 +1,6 @@ -# Other Guides - +Other Guides +============ +Well aren't you just a smart cookie for wanting to learn more! +Here throughout the different sub-sections of this section, we are going to provide some other useful guides that may be valuable! \ No newline at end of file diff --git a/understanding/README.md b/understanding/README.md index 078e144..ad1c315 100644 --- a/understanding/README.md +++ b/understanding/README.md @@ -1 +1,6 @@ -# Understanding +Understanding +============= + +We get it, there are a lot of words being thrown at you like "Collections", "Sharding", and all that shat like that. + +In this section, we will help you understand everything you need to understand to get you off your feet and on your way to making the next *"Dyno"* ! \ No newline at end of file