Skip to content

Commit 401fab5

Browse files
committed
rolemenus: reduce callouts density, correct some grammar
Reduce the callouts density to something more bearable and less yellow and blue; especially some notes are better off incorporated into the main text. Closes #77 Signed-off-by: Luca Zeuch <[email protected]>
1 parent 84d05ad commit 401fab5

File tree

1 file changed

+14
-35
lines changed

1 file changed

+14
-35
lines changed

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

Lines changed: 14 additions & 35 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,18 @@ 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" >}}
132127

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" >}}
128+
{{< callout context="note" title="Note: Message Reactions Limit" icon="outline/info-circle" >}}
139129

140130
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.
131+
If your role group has more than twenty you have to use the `rolemenu finish` sub-command and then add the rest of roles
132+
to a new message using the `-skip` flag.
143133

144134
{{< /callout >}}
145135

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

154144
### Step by step tutorial
155145

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

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

181167
![Third reaction on a rolemenu setup](rolemenu_react_3.png)
182168

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

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

199185
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-
205186
Note that YAGPDB does not allow you to disable error messages such as cool-down messages with the `nodm` switch or any
206187
other method.
207188

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

210192
### Remove roles on reaction remove
211193

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

243225
## How to get a message ID (Desktop)
244226

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 >}}
227+
Make sure you have enabled [developer mode](https://support.discordapp.com/hc/en-us/articles/206346498) in your Discord
228+
settings.
250229

251230
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.`
231+
of the message and click on `Copy Message ID`.
253232

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

0 commit comments

Comments
 (0)