Skip to content

Commit d60cfa5

Browse files
committed
Use consistent formatting of <kbd> tags in Moderator Instructions
HTML kbd tags are used to create graphical representations of the forum user interface buttons in the "Moderator Instructions" asset post. The visual appearance of the rendered content is enhanced by bolding text in the tags. The nesting of the markup can generally be in either order. However, nesting the bolding markup inside the kbd tags gives more flexibility by allowing text to be selectively bolded. For example, some graphical characters are clearer or faithful to the UI when not bolded. So the standardized style is to nest the bolding markup inside the kbd tags. Some of the markup did not comply with this standardized style.
1 parent ed1257d commit d60cfa5

File tree

1 file changed

+35
-35
lines changed
  • content/categories/staff/moderation/_topics/moderator-instructions

1 file changed

+35
-35
lines changed

content/categories/staff/moderation/_topics/moderator-instructions/1.md

Lines changed: 35 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -111,18 +111,18 @@ See the ["**Inappropriate behavior**" instructions](#deal-with-inappropriate-beh
111111

112112
##### [If the post is not spam](#if-the-post-is-not-spam)
113113

114-
1. Click the **<kbd>No</kbd>** button.
114+
1. Click the <kbd>**No**</kbd> button.
115115

116116
<a name="if-the-post-is-spam"></a>
117117

118118
##### [If the post is spam](#if-the-post-is-spam)
119119

120-
1. Click the **<kbd>Yes ▾</kbd>** button.
120+
1. Click the <kbd>**Yes ▾**</kbd> button.
121121
1. From the dropdown menu, click "**Suspend user**". The "**Suspend User**" dialog will open.
122122
1. From the "**Suspend user until**" dropdown menu, select "**Forever**".
123123
1. In the "**Suspension Reason**" text field, enter "spam".
124124
1. From the "**What would you like to do with the associated post?**" dropdown menu, select "**Delete the post**".
125-
1. Click the **<kbd>:no_entry_sign: Suspend</kbd>** button.
125+
1. Click the <kbd>**:no_entry_sign: Suspend**</kbd> button.
126126

127127
---
128128

@@ -134,7 +134,7 @@ The user submitting a "**Something Else**" flag will provide a message explainin
134134

135135
1. [Review the flag](#review-flag).
136136
1. If the flag warranted action, resolve it, following the relevant instructions provided elsewhere in this document. In cases where an "**Yes**" review was warranted but you are unable to take the external action to resolve the flag, just select "**Keep post**" from the <kbd>**Yes ▾**</kbd> menu. A message is generated in the ["**Moderators**" messages folder](https://forum.arduino.cc/my/messages/group/moderators) for each "**Something Else**" flag, and this message will be used to track the request.
137-
1. A private message is generated for each "**Something Else**" flag. This can be accessed directly via the flag's **<kbd>view full conversation</kbd>** button, or the ["**Moderators**" messages folder](https://forum.arduino.cc/my/messages/group/moderators). If the flag was resolved by the review interface itself, this message will automatically be archived. However, it is often not possible to resolve the flag via the review interface (e.g., [moving](#move-topic-to-correct-category) a topic to the appropriate category). In this case, the message must be manually archived by clicking its **<kbd>:file_folder: Archive</kbd>** button.
137+
1. A private message is generated for each "**Something Else**" flag. This can be accessed directly via the flag's <kbd>**view full conversation**</kbd> button, or the ["**Moderators**" messages folder](https://forum.arduino.cc/my/messages/group/moderators). If the flag was resolved by the review interface itself, this message will automatically be archived. However, it is often not possible to resolve the flag via the review interface (e.g., [moving](#move-topic-to-correct-category) a topic to the appropriate category). In this case, the message must be manually archived by clicking its <kbd>**:file_folder: Archive**</kbd> button.
138138

139139
![Archive message|356x500, 50%](https://europe1.discourse-cdn.com/arduino/original/4X/0/e/c/0ec0938faf6e77029655ff167701d3ca16bbdd3f.png)
140140

@@ -158,17 +158,17 @@ This flag is created by **`@system`** when a user account creation is detected a
158158

159159
##### [If the account is benign](#if-the-account-is-benign)
160160

161-
1. Click the **<kbd>Approve User</kbd>** button.
161+
1. Click the <kbd>**Approve User**</kbd> button.
162162

163163
<a name="if-the-account-is-malicious"></a>
164164

165165
##### [If the account is malicious](#if-the-account-is-malicious)
166166

167-
Please note that Arduino has a firm policy against deleting any accounts, so you must not use the **<kbd>Delete user...</kbd>** button Discourse presents. Instead, the following procedure is used to suspend the account:
167+
Please note that Arduino has a firm policy against deleting any accounts, so you must not use the <kbd>**Delete user...**</kbd> button Discourse presents. Instead, the following procedure is used to suspend the account:
168168

169169
1. Suspend the user account, [following these instructions](#suspend-an-account)
170170
1. Go back to [the flag review page](https://forum.arduino.cc/review).
171-
1. Click the **<kbd>Approve User</kbd>** button.
171+
1. Click the <kbd>**Approve User**</kbd> button.
172172
**** This is done to clear the flag in a manner compliant with [Arduino's user account policies](https://forum.arduino.cc/t/about-user-account-deletion-and-user-content-deletion/627095). It does not affect the suspension.
173173

174174
---
@@ -183,13 +183,13 @@ This flag is created by **`@system`** when a post is detected as possibly spam b
183183

184184
##### [If the post is benign](#if-the-post-is-benign-1)
185185

186-
1. Click the **<kbd>Not Spam</kbd>** button.
186+
1. Click the <kbd>**Not Spam**</kbd> button.
187187

188188
<a name="if-the-post-is-malicious-1"></a>
189189

190190
##### [If the post is malicious](#if-the-post-is-malicious-1)
191191

192-
1. Click the **<kbd>Yes ▾</kbd>** button.
192+
1. Click the <kbd>**Yes ▾**</kbd> button.
193193
1. From the dropdown menu, select "**Suspend User**".
194194

195195
---
@@ -210,18 +210,18 @@ This flag is created by **`@system`** when a new user created a topic, and anoth
210210

211211
##### [If the post is benign](#if-the-post-is-benign-2)
212212

213-
1. Click the **<kbd>No, restore post</kbd>** button.
213+
1. Click the <kbd>**No, restore post**</kbd> button.
214214

215215
<a name="if-the-post-is-malicious-2"></a>
216216

217217
##### [If the post is malicious](#if-the-post-is-malicious-2)
218218

219-
1. Click the **<kbd>Yes ▾</kbd>** button.
219+
1. Click the <kbd>**Yes ▾**</kbd> button.
220220
1. From the dropdown menu, click "**Suspend User**". The "**Suspend User**" dialog will open.
221221
1. From the "**Select a timeframe**" dropdown menu, select "**Forever**".
222222
1. In the "**Suspension Reason**" text field, enter "malicious use of multiple accounts".
223223
1. From the "**What would you like to do with the associated post?**" dropdown menu, select "**Delete the post**".
224-
1. Click the **<kbd>:no_entry_sign: Suspend</kbd>** button.
224+
1. Click the <kbd>**:no_entry_sign: Suspend**</kbd> button.
225225

226226
---
227227

@@ -281,12 +281,12 @@ Mentions of relevant products or services of interest to the Arduino community a
281281
1. Click the **⬤⬤⬤** icon at the bottom of the spam post.
282282
1. Click the **:black_flag:** icon.
283283
1. Click the "**It's Spam**" radio button.
284-
1. Click the **<kbd>Take Action... ▾</kbd>** button.
284+
1. Click the <kbd>**Take Action... ▾**</kbd> button.
285285
1. From the dropdown menu, click "**Suspend User**". The "**Suspend User**" dialog will open.
286286
1. From the "**Suspend user until**" dropdown menu, select "**Forever**".
287287
1. In the "**Suspension Reason**" text field, enter "spam".
288288
1. From the "**What would you like to do with the associated post?**" dropdown menu, select "**Delete the post**".
289-
1. Click the **<kbd>:no_entry_sign: Suspend</kbd>** button.
289+
1. Click the <kbd>**:no_entry_sign: Suspend**</kbd> button.
290290
1. Click the spammer's user name.
291291
1. Click the spammer's user name in the profile preview popup.
292292
1. Click the "**Activity**" tab to see their other posts.
@@ -353,9 +353,9 @@ If multiple cross-posts have valuable replies, they must be preserved by merging
353353
1. Click the wrench button ("topic actions") at the bottom of the topic.
354354
1. From the menu, select "**Select Posts...**". A "**You have selected 0 posts.**" dialog will open.
355355
1. If the entire thread is related to the cross-post, click "**select all**" in the dialog. If the cross-post was a [thread hijack](#split-hijacked-topic), then click the **<kbd>select</kbd>** button on each post related to the cross-post.
356-
1. Click the **<kbd>move to</kbd>** button. A "**Move to**" dialog will open.
356+
1. Click the <kbd>**move to**</kbd> button. A "**Move to**" dialog will open.
357357
1. Use the **"Search for a Topic"** field to find the cross-post topic to be kept. This can be done by entering its topic ID, which is the number at the end of the topic's URL. For example, the ID of this topic (`https://forum.arduino.cc/t/moderator-instructions/630548`) is `630548`.
358-
1. Click the **<kbd>Move to Existing Topic</kbd>** button.
358+
1. Click the <kbd>**Move to Existing Topic**</kbd> button.
359359

360360
---
361361

@@ -378,11 +378,11 @@ A topic hijack is when a user makes a reply that is not relevant to the topic. T
378378
1. Open the hijacked topic.
379379
1. Click the wrench button ("topic actions") at the bottom of the topic.
380380
1. From the menu, select "**Select Posts...**". A "**You have selected 0 posts.**" dialog will open.
381-
1. Click the **<kbd>select</kbd>** button on each post related to the hijack.
382-
1. Click the **<kbd>move to</kbd>** button. A "**Move to**" dialog will open.
381+
1. Click the <kbd>**select**</kbd> button on each post related to the hijack.
382+
1. Click the <kbd>**move to**</kbd> button. A "**Move to**" dialog will open.
383383
1. In the "**New Topic Title**" field, enter an appropriate title for the subject of the hijack post.
384384
1. Select the appropriate [forum category](https://forum.arduino.cc/categories) from the "**Category**" dropdown menu.
385-
1. Click the **<kbd>Move to New Topic</kbd>** button. The new topic will be created and opened in your browser.
385+
1. Click the <kbd>**Move to New Topic**</kbd> button. The new topic will be created and opened in your browser.
386386
1. In a reply to the newly created topic, add a ["Staff Post"](#make-staff-post):
387387
> Please don't hijack topics. I've had to split your post out to its own topic.
388388
>
@@ -508,7 +508,7 @@ This is the tool used by staff and automated systems to store documentation rela
508508
---
509509

510510
1. Open the user's profile page. This can be accessed by clicking their user name, then the user name in the profile preview popup.
511-
1. Click the **<kbd>User Notes</kbd>** button.
511+
1. Click the <kbd>**User Notes**</kbd> button.
512512

513513
<a name="user-activity"></a>
514514

@@ -527,8 +527,8 @@ This shows the user's posts, which can be used to find unreported inappropriate
527527
This tool allows you to see all the accounts associated with the user's [IP address](https://en.wikipedia.org/wiki/IP_address), which can be used to determine whether the user has other accounts (e.g., circumventing a [suspension](#suspend-an-account), [sock puppets](https://en.wikipedia.org/wiki/Sock_puppet_account)).
528528

529529
1. Open the user's profile page. This can be accessed by clicking their user name, then the user name in the profile preview popup.
530-
1. Click the **<kbd>Admin</kbd>** button.
531-
1. Click the **<kbd>:globe_with_meridians: IP Lookup</kbd>** button.
530+
1. Click the <kbd>**Admin**</kbd> button.
531+
1. Click the <kbd>**:globe_with_meridians: IP Lookup**</kbd> button.
532532
1. Check whether any other accounts are listed under the "**Other accounts with this IP address**" section.
533533

534534
<a name="action-logs"></a>
@@ -538,8 +538,8 @@ This tool allows you to see all the accounts associated with the user's [IP addr
538538
This shows all staff actions that affected the user's account. The [User Notes](#user-notes) will generally contain entries for all important actions, as well as manually added notes, so check User Notes first.
539539

540540
1. Open the user's profile page. This can be accessed by clicking their user name, then the user name in the profile preview popup.
541-
1. Click the **<kbd>Admin</kbd>** button.
542-
1. Click the **<kbd>Action Logs</kbd>** button.
541+
1. Click the <kbd>**Admin**</kbd> button.
542+
1. Click the <kbd>**Action Logs**</kbd> button.
543543

544544
---
545545

@@ -569,7 +569,7 @@ User notes can be associated with a post. These are the same as the [User Notes
569569
1. Click the wrench icon.
570570
1. Click "**Add User Note**".
571571
1. Write the User Note.
572-
1. Click the **<kbd>Add User Note</kbd>** button.
572+
1. Click the <kbd>**Add User Note**</kbd> button.
573573

574574
---
575575

@@ -578,9 +578,9 @@ User notes can be associated with a post. These are the same as the [User Notes
578578
#### [User Notes general to an account](#user-notes-general-to-an-account)
579579

580580
1. Open the user's profile page. This can be accessed by clicking their user name, then the user name in the profile preview popup.
581-
1. Click the **<kbd>User Notes</kbd>** button. The user notes will be displayed, as well as a field for adding new notes.
581+
1. Click the <kbd>**User Notes**</kbd> button. The user notes will be displayed, as well as a field for adding new notes.
582582
1. Write the User Note.
583-
1. Click the **<kbd>Add User Note</kbd>** button.
583+
1. Click the <kbd>**Add User Note**</kbd> button.
584584

585585
---
586586

@@ -612,12 +612,12 @@ The user's privileges on the forum are dependent on their "Trust Level" (TL). Th
612612
Detailed information about Trust Levels: https://blog.discourse.org/2018/06/understanding-discourse-trust-levels/
613613

614614
1. Open the user's profile page. This can be accessed by clicking their user name, then the user name in the profile preview popup.
615-
1. Click the **<kbd>Admin</kbd>** button.
615+
1. Click the <kbd>**Admin**</kbd> button.
616616
1. From the "**Permissions**" section, click the "**Trust Level**" dropdown menu.
617617
1. Select the desired level from the menu.
618-
1. Click the **<kbd>:heavy_check_mark:</kbd>** button.
619-
1. If you would like to prevent the automated adjustment of trust level by the forum software, click the **<kbd>Lock Trust Level</kbd>** button.
620-
If the trust level was previously locked and you want to unlock it, then click the **<kbd>Unlock Trust Level</kbd>** button.
618+
1. Click the <kbd>**:heavy_check_mark:**</kbd> button.
619+
1. If you would like to prevent the automated adjustment of trust level by the forum software, click the <kbd>**Lock Trust Level**</kbd> button.
620+
If the trust level was previously locked and you want to unlock it, then click the <kbd>**Unlock Trust Level**</kbd> button.
621621

622622
---
623623

@@ -634,11 +634,11 @@ The "Silence" action is used in cases where the intent is to temporarily curtail
634634
---
635635

636636
1. Open the user's profile page. This can be accessed by clicking their user name, then the user name in the profile preview popup.
637-
1. Click the **<kbd>Admin</kbd>** button.
637+
1. Click the <kbd>**Admin**</kbd> button.
638638
1. From the "**Permissions**" section, click the <kbd>**Silence**</kbd> button.
639639
1. From the "**Select a timeframe**" dropdown menu, select the desired duration of the silencing.
640640
1. In the "**Silence Reason**" text field, enter a short explanation for the cause for the silencing.
641-
1. Click the **<kbd>Silence</kbd>** button.
641+
1. Click the <kbd>**Silence**</kbd> button.
642642

643643
---
644644

@@ -661,11 +661,11 @@ Account suspensions are used when the intention is to permanently exclude the us
661661
---
662662

663663
1. Open the user's profile page. This can be accessed by clicking their user name, then the user name in the profile preview popup.
664-
1. Click the **<kbd>Admin</kbd>** button.
664+
1. Click the <kbd>**Admin**</kbd> button.
665665
1. From the "**Permissions**" section, click the <kbd>**🛇 Suspend**</kbd> button.
666666
1. From the "**Suspend user until**" dropdown menu, select "**Forever**".
667667
1. In the "**Suspension Reason**" text field, enter a short explanation for the cause of suspension (e.g., "spam").
668-
1. Click the **<kbd>:no_entry_sign: Suspend</kbd>** button.
668+
1. Click the <kbd>**:no_entry_sign: Suspend**</kbd> button.
669669

670670
---
671671

0 commit comments

Comments
 (0)