From e54f4c345e0ffd98b26e237641c978cf0e2a8666 Mon Sep 17 00:00:00 2001 From: wizard7377 <76231370+wizard7377@users.noreply.github.com> Date: Tue, 27 Jun 2023 06:08:27 -0400 Subject: [PATCH 01/11] Add files via upload --- docpages/disdppgloss.md | 51 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 docpages/disdppgloss.md diff --git a/docpages/disdppgloss.md b/docpages/disdppgloss.md new file mode 100644 index 0000000000..5ea1175570 --- /dev/null +++ b/docpages/disdppgloss.md @@ -0,0 +1,51 @@ +## A Glossary of Common Discord Terms + +Here is a list of common terms that are both terms one should know if one is to use D++ (or any other discord library) however are terms that are not commonly used throughout the discord community. This list, with a few exceptions, ***is discord specific***, that is to say, this is not a explanation of commonly used C++ terms, it is for people who are not familiar with the terminology of the discord API. + +#### Glossary + +Listed in alphabetical order, with terms in bold, here are the basics on... + +1. **Action row**: A collection of up to five **components**, which is attached to a message + +2. **Audit log**: A log of **events**, that have happened in a **guild** + +3. **Auto mod**: Discord's low-code solution to moderation, however it is very limited in scope + +4. **Badge**: A decoration on someone's profile showing certain things about them, such as if they have nitro, if they are a discord developer, etc. + +5. **Bot token**: A secret string of characters, this is how you login to your bot, if you lose it or it gets leaked, you will have to get a new one from the discord developer portal, and it is necessary to use in your bot + +6. **Button**: A **component** on a message that can be styled, that sends an **event** when clicked on by a user + +7. **Cache**: A type of storage efficient for things like messages + +8. **Callback**: While not strictly related to discord, it is used a LOT in D++, so a callback is when a function is passed to another function, sort of like how you might give someone a telephone number (you give them the means to do some sort of interaction rather than asking them how to interact), which is used to handle responses to **events** + +9. **Cluster**: A singular bot application, which is composed of one or more **shards**, a **cluster** is the center of bot development + +10. **(Slash) command**: The primary way a user interacts with a bot, it is a command sent to the bot with **parameters**, which may be optional, and is initiated by staring a message with `/`. + +11. **Component**: A component is anything that can appear in a bot's message besides text, such as **buttons** and **select menus**. + +12. **Drop down/Select menu**: A **component** of a message that upon being clicked, drops down and allows the user to select an option + +13. **Embeds**: A widget attached to a message, which can contain multiple fields of texts, an image, and much more information + +14. **Ephemeral**: A direct message to a user in a public channel, eventually disappears, it is mainly used to give information to a user + +15. **Event**: Something that a Discord bot can respond to, such as a message being sent, a **button** being clicked, or an option being selected, among others. + +16. **Guild**: What the Discord API (and most libraries for it) call a server + +17. **Intents**: Similar to a guild, a name for permissions of a bot + +18. **Interaction**: Something that can be responded to, and it is the main part of an **event** that will be accessed in an application + +19. **Modal**: A pop up form that contains text that can be sent by a bot + +20. **Shards and clusters**: A cluster is the main container for an application, which contains many shards, each of which manage a subset of your workload, fortunately, D++ does this automatically + +21. **Snowflake**: An unsigned 64 bit integer (it can represent anything from 0 to 2^64) that is used by discord to identify basically everything, including but not limited to, **guilds**, users, messages, and much more + +22. **Subcommands**: A command which is derived from a different command, for example a bot that allows a person to get statistics for discord might have a `stats guild` command and a `stats global` command both of which are **subcommands** of `stats` From b59f51cab301917746653d4a31f9c575fda4f963 Mon Sep 17 00:00:00 2001 From: wizard7377 <76231370+wizard7377@users.noreply.github.com> Date: Tue, 27 Jun 2023 06:16:25 -0400 Subject: [PATCH 02/11] Update INDEX.md --- docpages/INDEX.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docpages/INDEX.md b/docpages/INDEX.md index 549233556e..ca7e22743f 100644 --- a/docpages/INDEX.md +++ b/docpages/INDEX.md @@ -66,6 +66,7 @@ The library should work fine on other operating systems as well, and if you run * [Frequently Asked Questions](/md_docpages_01_frequently_asked_questions.html) * [Installing D++](/md_docpages_01_installing.html) * [Example Programs](/md_docpages_03_example_programs.html) +* [Commonly used terms](/md_docpages_disdppgloss.html) ## Architecture * \ref clusters-shards-guilds From 0057ab738c3573155f3ef8ee56db154f709ca0e1 Mon Sep 17 00:00:00 2001 From: wizard7377 <76231370+wizard7377@users.noreply.github.com> Date: Tue, 27 Jun 2023 06:19:32 -0400 Subject: [PATCH 03/11] Update disdppgloss.md --- docpages/disdppgloss.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docpages/disdppgloss.md b/docpages/disdppgloss.md index 5ea1175570..de6bad13e1 100644 --- a/docpages/disdppgloss.md +++ b/docpages/disdppgloss.md @@ -44,7 +44,7 @@ Listed in alphabetical order, with terms in bold, here are the basics on... 19. **Modal**: A pop up form that contains text that can be sent by a bot -20. **Shards and clusters**: A cluster is the main container for an application, which contains many shards, each of which manage a subset of your workload, fortunately, D++ does this automatically +20. [**Shards and clusters**](https://dpp.dev/clusters-shards-guilds.html): A cluster is the main container for an application, which contains many shards, each of which manage a subset of your workload, fortunately, D++ does this automatically 21. **Snowflake**: An unsigned 64 bit integer (it can represent anything from 0 to 2^64) that is used by discord to identify basically everything, including but not limited to, **guilds**, users, messages, and much more From 037b938313d3befcba351451d0a61be9091322c9 Mon Sep 17 00:00:00 2001 From: wizard7377 <76231370+wizard7377@users.noreply.github.com> Date: Wed, 12 Jul 2023 15:59:01 -0400 Subject: [PATCH 04/11] Update .cspell.json --- .cspell.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/.cspell.json b/.cspell.json index 69cc4249aa..c836d1b2c1 100644 --- a/.cspell.json +++ b/.cspell.json @@ -96,7 +96,8 @@ "CORO", "cback", "mentionables", - "stringified" + "stringified", + "disdppgloss" ], "flagWords": [ "hte" From 5891d5643bbb28f0c33c1bca18bce374d6cc89cf Mon Sep 17 00:00:00 2001 From: wizard7377 <76231370+wizard7377@users.noreply.github.com> Date: Wed, 9 Aug 2023 08:54:23 -0400 Subject: [PATCH 05/11] Update disdppgloss.md --- docpages/disdppgloss.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docpages/disdppgloss.md b/docpages/disdppgloss.md index de6bad13e1..3d1178d57b 100644 --- a/docpages/disdppgloss.md +++ b/docpages/disdppgloss.md @@ -32,19 +32,19 @@ Listed in alphabetical order, with terms in bold, here are the basics on... 13. **Embeds**: A widget attached to a message, which can contain multiple fields of texts, an image, and much more information -14. **Ephemeral**: A direct message to a user in a public channel, eventually disappears, it is mainly used to give information to a user +14. **Ephemeral**: A message only visible to the user being replied to 15. **Event**: Something that a Discord bot can respond to, such as a message being sent, a **button** being clicked, or an option being selected, among others. 16. **Guild**: What the Discord API (and most libraries for it) call a server -17. **Intents**: Similar to a guild, a name for permissions of a bot +17. **Intents**: The right for a bot to receive certain data from the Discord API 18. **Interaction**: Something that can be responded to, and it is the main part of an **event** that will be accessed in an application 19. **Modal**: A pop up form that contains text that can be sent by a bot -20. [**Shards and clusters**](https://dpp.dev/clusters-shards-guilds.html): A cluster is the main container for an application, which contains many shards, each of which manage a subset of your workload, fortunately, D++ does this automatically +20. [**Shards and clusters**](\ref clusters-shards-guilds): A cluster is the main container for an application, which contains many shards, each of which manage a subset of your workload, fortunately, D++ does this automatically 21. **Snowflake**: An unsigned 64 bit integer (it can represent anything from 0 to 2^64) that is used by discord to identify basically everything, including but not limited to, **guilds**, users, messages, and much more From d6e9aceeaf10ddf149f7bdc67a80ebc174c7bc58 Mon Sep 17 00:00:00 2001 From: wizard7377 <76231370+wizard7377@users.noreply.github.com> Date: Wed, 9 Aug 2023 15:30:40 -0400 Subject: [PATCH 06/11] Update disdppgloss.md --- docpages/disdppgloss.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docpages/disdppgloss.md b/docpages/disdppgloss.md index 3d1178d57b..1c4ca7c339 100644 --- a/docpages/disdppgloss.md +++ b/docpages/disdppgloss.md @@ -24,7 +24,7 @@ Listed in alphabetical order, with terms in bold, here are the basics on... 9. **Cluster**: A singular bot application, which is composed of one or more **shards**, a **cluster** is the center of bot development -10. **(Slash) command**: The primary way a user interacts with a bot, it is a command sent to the bot with **parameters**, which may be optional, and is initiated by staring a message with `/`. +10. **\(Slash\) command**: The primary way a user interacts with a bot, it is a command sent to the bot with **parameters**, which may be optional, and is initiated by staring a message with `/`. 11. **Component**: A component is anything that can appear in a bot's message besides text, such as **buttons** and **select menus**. @@ -44,7 +44,7 @@ Listed in alphabetical order, with terms in bold, here are the basics on... 19. **Modal**: A pop up form that contains text that can be sent by a bot -20. [**Shards and clusters**](\ref clusters-shards-guilds): A cluster is the main container for an application, which contains many shards, each of which manage a subset of your workload, fortunately, D++ does this automatically +20. **[Shards and clusters](\ref clusters-shards-guilds)**: A cluster is the main container for an application, which contains many shards, each of which manage a subset of your workload, fortunately, D++ does this automatically 21. **Snowflake**: An unsigned 64 bit integer (it can represent anything from 0 to 2^64) that is used by discord to identify basically everything, including but not limited to, **guilds**, users, messages, and much more From f5b5b9ca653f79dbda5d0293e6f1e9f3811db7ba Mon Sep 17 00:00:00 2001 From: wizard7377 <76231370+wizard7377@users.noreply.github.com> Date: Thu, 10 Aug 2023 11:20:12 -0400 Subject: [PATCH 07/11] Fixed comma nightmare --- docpages/disdppgloss.md | 41 +++++++++++++++++++++-------------------- 1 file changed, 21 insertions(+), 20 deletions(-) diff --git a/docpages/disdppgloss.md b/docpages/disdppgloss.md index 1c4ca7c339..5359f0bf2c 100644 --- a/docpages/disdppgloss.md +++ b/docpages/disdppgloss.md @@ -1,51 +1,52 @@ ## A Glossary of Common Discord Terms -Here is a list of common terms that are both terms one should know if one is to use D++ (or any other discord library) however are terms that are not commonly used throughout the discord community. This list, with a few exceptions, ***is discord specific***, that is to say, this is not a explanation of commonly used C++ terms, it is for people who are not familiar with the terminology of the discord API. +Here is a list of common terms that are both terms one should know if one is to use D++ (or any other discord library) however are terms that are not commonly used throughout the discord community. This list, with a few exceptions, ***is discord specific***, that is to say that this is not a explanation of commonly used C++ terms, it is for people who are not familiar with the terminology of the discord API and libraries themselves. #### Glossary Listed in alphabetical order, with terms in bold, here are the basics on... -1. **Action row**: A collection of up to five **components**, which is attached to a message +1. **Action row**: A collection of up to five **components** which is attached to a message. -2. **Audit log**: A log of **events**, that have happened in a **guild** +2. **Audit log**: A log of **events** that have happened in a **guild**. -3. **Auto mod**: Discord's low-code solution to moderation, however it is very limited in scope +3. **Auto mod**: Discord's low-code solution to moderation. However, it is very limited in scope. 4. **Badge**: A decoration on someone's profile showing certain things about them, such as if they have nitro, if they are a discord developer, etc. -5. **Bot token**: A secret string of characters, this is how you login to your bot, if you lose it or it gets leaked, you will have to get a new one from the discord developer portal, and it is necessary to use in your bot +5. **Bot token**: A secret string of characters that is used as a "login" to your bot. If you lose it or it gets leaked you will have to get a new one from the discord developer portal, so be sure to keep it in a place that is both secure and where you won't forget it. -6. **Button**: A **component** on a message that can be styled, that sends an **event** when clicked on by a user +6. **Button**: A **component** on a message that can be styled that sends an **event** when clicked on by a user. -7. **Cache**: A type of storage efficient for things like messages +7. **Cache**: A type of storage efficient for things like messages. -8. **Callback**: While not strictly related to discord, it is used a LOT in D++, so a callback is when a function is passed to another function, sort of like how you might give someone a telephone number (you give them the means to do some sort of interaction rather than asking them how to interact), which is used to handle responses to **events** +8. **Callback**: While not strictly related to discord, it is used a LOT in D++. A callback is when a function is passed to another function, sort of like how you might give someone a telephone number (you give them the means to do some sort of interaction rather than asking them how to interact), which is used to handle responses to **events**. -9. **Cluster**: A singular bot application, which is composed of one or more **shards**, a **cluster** is the center of bot development +9. **Cluster**: A singular bot application, which is composed of one or more **shards**, a **cluster** is the center of bot development. -10. **\(Slash\) command**: The primary way a user interacts with a bot, it is a command sent to the bot with **parameters**, which may be optional, and is initiated by staring a message with `/`. +10. **\(Slash\) command**: The primary way a user interacts with a bot. It is a command sent to the bot with **parameters** (which may be optional) and is initiated by staring a message with `/`. 11. **Component**: A component is anything that can appear in a bot's message besides text, such as **buttons** and **select menus**. -12. **Drop down/Select menu**: A **component** of a message that upon being clicked, drops down and allows the user to select an option +12. **Drop down/Select menu**: A **component** of a message that upon being clicked drops down and allows the user to select an option. -13. **Embeds**: A widget attached to a message, which can contain multiple fields of texts, an image, and much more information +13. **Embeds**: A widget attached to a message which can contain multiple fields of texts, an image, and much more information. -14. **Ephemeral**: A message only visible to the user being replied to +14. **Ephemeral**: A message only visible to the user being replied to. 15. **Event**: Something that a Discord bot can respond to, such as a message being sent, a **button** being clicked, or an option being selected, among others. -16. **Guild**: What the Discord API (and most libraries for it) call a server +16. **Guild**: What the Discord API (and most libraries for it) call a server. -17. **Intents**: The right for a bot to receive certain data from the Discord API +17. **Intents**: The right for a bot to receive certain data from the Discord API. -18. **Interaction**: Something that can be responded to, and it is the main part of an **event** that will be accessed in an application +18. **Interaction**: Something that can be responded to. It is the main part of an **event** that will be accessed in an application. -19. **Modal**: A pop up form that contains text that can be sent by a bot +19. **Modal**: A pop up form that contains text that can be sent by a bot. -20. **[Shards and clusters](\ref clusters-shards-guilds)**: A cluster is the main container for an application, which contains many shards, each of which manage a subset of your workload, fortunately, D++ does this automatically +20. **[Shards and clusters](\ref clusters-shards-guilds)**: A cluster is the main container for an application which contains many shards, each of which manage a subset of your workload, fortunately, D++ does this automatically. -21. **Snowflake**: An unsigned 64 bit integer (it can represent anything from 0 to 2^64) that is used by discord to identify basically everything, including but not limited to, **guilds**, users, messages, and much more +21. **Snowflake**: An unsigned 64 bit integer (it can represent anything from $0$ to $2^{64}-1$) that is used by discord to identify basically everything, including but not limited to, **guilds**, users, messages, and much more. + +22. **Subcommands**: A command which is derived from a different command, such as a bot that allows a person to get statistics for discord might have a `stats guild` command and a `stats global` command, both of which are **subcommands** of `stats`. -22. **Subcommands**: A command which is derived from a different command, for example a bot that allows a person to get statistics for discord might have a `stats guild` command and a `stats global` command both of which are **subcommands** of `stats` From 83888244e5724f7718f2f0357ffd674d497b078f Mon Sep 17 00:00:00 2001 From: wizard7377 <76231370+wizard7377@users.noreply.github.com> Date: Thu, 10 Aug 2023 11:34:04 -0400 Subject: [PATCH 08/11] Fixed math --- docpages/disdppgloss.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docpages/disdppgloss.md b/docpages/disdppgloss.md index 5359f0bf2c..73df904d1a 100644 --- a/docpages/disdppgloss.md +++ b/docpages/disdppgloss.md @@ -46,7 +46,7 @@ Listed in alphabetical order, with terms in bold, here are the basics on... 20. **[Shards and clusters](\ref clusters-shards-guilds)**: A cluster is the main container for an application which contains many shards, each of which manage a subset of your workload, fortunately, D++ does this automatically. -21. **Snowflake**: An unsigned 64 bit integer (it can represent anything from $0$ to $2^{64}-1$) that is used by discord to identify basically everything, including but not limited to, **guilds**, users, messages, and much more. +21. **Snowflake**: An unsigned 64 bit integer (it can represent anything from \f$0\f$ to \f$2^{64}-1\f$) that is used by discord to identify basically everything, including but not limited to, **guilds**, users, messages, and much more. 22. **Subcommands**: A command which is derived from a different command, such as a bot that allows a person to get statistics for discord might have a `stats guild` command and a `stats global` command, both of which are **subcommands** of `stats`. From 6ec14fd578039e0299f30dd04ed69ebd2c190120 Mon Sep 17 00:00:00 2001 From: wizard7377 <76231370+wizard7377@users.noreply.github.com> Date: Thu, 10 Aug 2023 11:41:29 -0400 Subject: [PATCH 09/11] Update disdppgloss.md --- docpages/disdppgloss.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docpages/disdppgloss.md b/docpages/disdppgloss.md index 73df904d1a..5e11310653 100644 --- a/docpages/disdppgloss.md +++ b/docpages/disdppgloss.md @@ -46,7 +46,7 @@ Listed in alphabetical order, with terms in bold, here are the basics on... 20. **[Shards and clusters](\ref clusters-shards-guilds)**: A cluster is the main container for an application which contains many shards, each of which manage a subset of your workload, fortunately, D++ does this automatically. -21. **Snowflake**: An unsigned 64 bit integer (it can represent anything from \f$0\f$ to \f$2^{64}-1\f$) that is used by discord to identify basically everything, including but not limited to, **guilds**, users, messages, and much more. +21. **Snowflake**: An unsigned 64 bit integer (it can represent anything from 0 to (2^64)-1) that is used by discord to identify basically everything, including but not limited to, **guilds**, users, messages, and much more. 22. **Subcommands**: A command which is derived from a different command, such as a bot that allows a person to get statistics for discord might have a `stats guild` command and a `stats global` command, both of which are **subcommands** of `stats`. From d48142af52665bdc26f4e684f17d270f471dea1c Mon Sep 17 00:00:00 2001 From: wizard7377 <76231370+wizard7377@users.noreply.github.com> Date: Thu, 10 Aug 2023 16:37:47 -0400 Subject: [PATCH 10/11] Update disdppgloss.md --- docpages/disdppgloss.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/docpages/disdppgloss.md b/docpages/disdppgloss.md index 5e11310653..4a05011752 100644 --- a/docpages/disdppgloss.md +++ b/docpages/disdppgloss.md @@ -1,6 +1,6 @@ ## A Glossary of Common Discord Terms -Here is a list of common terms that are both terms one should know if one is to use D++ (or any other discord library) however are terms that are not commonly used throughout the discord community. This list, with a few exceptions, ***is discord specific***, that is to say that this is not a explanation of commonly used C++ terms, it is for people who are not familiar with the terminology of the discord API and libraries themselves. +This is a list of terms that one should know if you want use D++ (or any other discord library). These terms are not D++ specific, and are commonly used throughout most of the Discord developer community. This list, with a few exceptions, ***is discord specific***, that is to say that this is not a explanation of commonly used C++ terms, it is for people who are not familiar with the terminology of the discord API and libraries themselves. #### Glossary @@ -40,13 +40,12 @@ Listed in alphabetical order, with terms in bold, here are the basics on... 17. **Intents**: The right for a bot to receive certain data from the Discord API. -18. **Interaction**: Something that can be responded to. It is the main part of an **event** that will be accessed in an application. +18. **Interaction**: A object that contains information about whenever a user interacts with a application, such as sending a message or clicking a button. It is the main part of an **event** that will be accessed in an application. 19. **Modal**: A pop up form that contains text that can be sent by a bot. 20. **[Shards and clusters](\ref clusters-shards-guilds)**: A cluster is the main container for an application which contains many shards, each of which manage a subset of your workload, fortunately, D++ does this automatically. -21. **Snowflake**: An unsigned 64 bit integer (it can represent anything from 0 to (2^64)-1) that is used by discord to identify basically everything, including but not limited to, **guilds**, users, messages, and much more. +21. **Snowflake**: An unsigned 64 bit integer (it can represent anything from $0$ to $2^{64}-1$) that is used by discord to identify basically everything, including but not limited to, **guilds**, users, messages, and much more. 22. **Subcommands**: A command which is derived from a different command, such as a bot that allows a person to get statistics for discord might have a `stats guild` command and a `stats global` command, both of which are **subcommands** of `stats`. - From 805781bca616766bef840711f9df5b5f806c4d09 Mon Sep 17 00:00:00 2001 From: wizard7377 <76231370+wizard7377@users.noreply.github.com> Date: Fri, 11 Aug 2023 07:47:36 -0400 Subject: [PATCH 11/11] Update disdppgloss.md --- docpages/disdppgloss.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docpages/disdppgloss.md b/docpages/disdppgloss.md index 4a05011752..94db16c39d 100644 --- a/docpages/disdppgloss.md +++ b/docpages/disdppgloss.md @@ -44,8 +44,8 @@ Listed in alphabetical order, with terms in bold, here are the basics on... 19. **Modal**: A pop up form that contains text that can be sent by a bot. -20. **[Shards and clusters](\ref clusters-shards-guilds)**: A cluster is the main container for an application which contains many shards, each of which manage a subset of your workload, fortunately, D++ does this automatically. +20. **[Shards](\ref clusters-shards-guilds)**: A shard manages part of the workload of your Discord application -21. **Snowflake**: An unsigned 64 bit integer (it can represent anything from $0$ to $2^{64}-1$) that is used by discord to identify basically everything, including but not limited to, **guilds**, users, messages, and much more. +21. **Snowflake**: An unsigned 64 bit integer (it can represent anything from 0 to 2^64-1) that is used by discord to identify basically everything, including but not limited to, **guilds**, users, messages, and much more. 22. **Subcommands**: A command which is derived from a different command, such as a bot that allows a person to get statistics for discord might have a `stats guild` command and a `stats global` command, both of which are **subcommands** of `stats`.