Skip to content

Commit 29dd657

Browse files
authored
Merge pull request #80 from botlabs-gg/rolemenu-reduce-callouts
rolemenus: reduce callouts density, correct some grammar
2 parents 84d05ad + 0d866a8 commit 29dd657

File tree

2 files changed

+13
-37
lines changed

2 files changed

+13
-37
lines changed

content/docs/reference/custom-interactions.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -115,7 +115,6 @@ representing allowed channel types.
115115
| text | A simple dropdown menu with custom text options. |
116116
| user | A list of users part of the server, automatically populated by Discord. |
117117

118-
119118
#### Select Menu Option
120119

121120
A select menu option for the `text` type has the structure as outlined in the table below. A text menu may not have more

content/docs/tools-and-utilities/self-assignable-roles.md

Lines changed: 13 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -10,8 +10,6 @@ description = "how2 reaction role"
1010

1111
{{< youtube IaTfJ4vqHhc >}}
1212

13-
[Tutorial Video](https://www.youtube.com/watch?v=IaTfJ4vqHhc)
14-
1513
## Role Commands
1614

1715
{{< callout context="caution" title="Warning: Required Bot Permissions" icon="outline/alert-triangle" >}}
@@ -47,19 +45,15 @@ the role you are assigning either, _unless_ you wish to prevent the user from re
4745

4846
## Role Groups
4947

50-
{{< callout context="note" title="Note: Role Menu Configuration" icon="outline/info-circle" >}}
51-
52-
Role groups are essential if you want to set up a role menu.
53-
54-
{{< /callout >}}
55-
5648
Role groups are useful for applying restrictions on a group of roles such as only being able to have one or the other
5749
role etc. They're also essential if you want to create a role menu. To create one, simply give the role group a name and
5850
then select which mode you want the role group to use.
5951

6052
Every role group, even Ungrouped has the option to delete all roles inside that group, other groups will not be
6153
affected. Be careful with that, it's permanent and can't be undone.
6254

55+
They're essential if you want to create a role menu.
56+
6357
![Creation of a role command group](role_command_group_creation.png)
6458

6559
### The different modes
@@ -124,22 +118,17 @@ starting. Role menu will **not** work if you have not done so.
124118

125119
{{< /callout >}}
126120

127-
The role menu makes it possible to have people assign roles by adding reactions to a message.
121+
The role menu makes it possible to have people assign roles by adding reactions to a message. If you'd like to create a
122+
message like in the example to create a rolemenu on, take a look at the [Custom Embeds](/docs/reference/custom-embeds)
123+
chapter.
128124

129125
![Example of a role menu](rolemenu_example.png)
130126

131-
{{< callout context="note" title="Note: Custom Embeds" icon="outline/info-circle" >}}
132-
133-
If you'd like to create a message like the above to create a rolemenu on, take a look at the
134-
[Custom Embeds](/docs/reference/custom-embeds) chapter.
135-
136-
{{< /callout >}}
137-
138-
{{< callout context="caution" title="Warning: Message Reactions Limit" icon="outline/alert-triangle" >}}
127+
{{< callout context="note" title="Note: Message Reactions Limit" icon="outline/info-circle" >}}
139128

140129
A role menu can only support up to 20 roles due to the reaction limit discord places on messages.
141-
If your role group has more then twenty you have to use finish sub-command and then add the rest of roles to a new
142-
message with -skip flag.
130+
If your role group has more than twenty you have to use the `rolemenu finish` sub-command and then add the rest of roles
131+
to a new message using the `-skip` flag.
143132

144133
{{< /callout >}}
145134

@@ -153,14 +142,10 @@ message, or add new role to your role menu, be sure to read until the end.
153142

154143
### Step by step tutorial
155144

156-
{{< callout context="caution" title="Warning: Prerequisites" icon="outline/alert-triangle" >}}
157-
158145
Make sure you created your [role commands](#role-commands) and assigned them a [role group](#role-groups) before
159146
starting. Role menu will **not** work if you have not done so. All switches and flags (nodm, rr, etc...) start with
160147
hyphen symbol `-`, not your prefix.
161148

162-
{{< /callout >}}
163-
164149
Once you've made your role commands and assigned them to a role group, go to the channel in Discord where you want the
165150
role menu to be created. Then type `-rolemenu create (group name)`; applying our "Sports" role group example, we'd have
166151
to send `-rolemenu create Sports`.
@@ -180,7 +165,7 @@ And similar for the final role, **Basketball:**
180165

181166
![Third reaction on a rolemenu setup](rolemenu_react_3.png)
182167

183-
And we're done --- people can start using the menu by clicking on the reaction associated with their desired role.
168+
And we're done---people can start using the menu by clicking on the reaction associated with their desired role.
184169
The setup message will be automatically deleted in a couple of minutes, but you can also delete it manually, if you so
185170
desire.
186171

@@ -197,15 +182,10 @@ If you do not want the bot to send you a DM when you are given or removed from a
197182
`-rolemenu update (message id) -nodm`.
198183

199184
After you have finish editing or creating your role menu, it will display whether DM notifications are enabled or not.
200-
201-
![Rolemenu flags display](rolemenu_flags.png)
202-
203-
{{< callout context="caution" title="Warning: Errors Cannot be Disabled" icon="outline/alert-triangle" >}}
204-
205185
Note that YAGPDB does not allow you to disable error messages such as cool-down messages with the `nodm` switch or any
206186
other method.
207187

208-
{{< /callout >}}
188+
![Rolemenu flags display](rolemenu_flags.png)
209189

210190
### Remove roles on reaction remove
211191

@@ -242,13 +222,10 @@ If you added a new role to your role group, you can update your role menu. Updat
242222

243223
## How to get a message ID (Desktop)
244224

245-
{{< callout context="note" title="Note: Developer Mode" icon="outline/info-circle" >}}
246-
247-
Make sure you have [developer mode turned on in your discord settings.](https://support.discordapp.com/hc/en-us/articles/206346498)
248-
249-
{{< /callout >}}
225+
Make sure you have enabled [developer mode](https://support.discordapp.com/hc/en-us/articles/206346498) in your Discord
226+
settings.
250227

251228
To get the ID of the message you want to set the custom role menu on, click on the three dots on the far right hand side
252-
of the message and click on `Copy ID.`
229+
of the message and click on `Copy Message ID`.
253230

254231
![Copying a message ID](copy_message_id.png)

0 commit comments

Comments
 (0)