Skip to content

Commit f125ee6

Browse files
committed
Quote non-prose references in "Moderator Instructions"
Technical writing such as the "Moderator Instructions" asset post is often littered with non-prose text such as references to: - UI elements - navigation items - product names The reader may have difficulty understanding when text is prose vs a reference to one of these items. For this reason, readability is improved by formatting the text so that there is a clear visual difference between the standard prose text and the non-prose items. One of the formatting techniques that can be employed to accomplish this is quoting these types of non-prose text. Since the primary technique is bolding the text, quoting is used selectively in cases where additional visual differentiation is useful. That formatting convention was already employed in the document, but was missing in some places. The formatting is hereby done consistently throughout the document.
1 parent 4c6fec6 commit f125ee6

File tree

1 file changed

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

1 file changed

+24
-24
lines changed

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

Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ These are instructions for common moderation actions.
22

33
For general moderation guidelines, see the ["**Moderator Guidelines**" topic](https://forum.arduino.cc/t/moderation-guidelines/54905).
44

5-
For an overview of the Discourse moderation system, see the **[Discourse Moderation Guide](https://meta.discourse.org/t/discourse-moderation-guide/63116)**.
5+
For an overview of the Discourse moderation system, see the "[**Discourse Moderation Guide**](https://meta.discourse.org/t/discourse-moderation-guide/63116)".
66

77
---
88

@@ -118,10 +118,10 @@ See the [**"Inappropriate behavior"**](#deal-with-inappropriate-behavior) instru
118118
##### [If the post is spam](#if-the-post-is-spam)
119119

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

127127
---
@@ -133,7 +133,7 @@ See the [**"Inappropriate behavior"**](#deal-with-inappropriate-behavior) instru
133133
The user submitting a "**Something Else**" flag will provide a message explaining the purpose of the flag. This might be used to flag problematic posts that don't fit into any of the standard user-submitted flag categories, or simply as an efficient means of communicating with the moderators about a benign post (e.g., requesting a tutorial topic be closed to discussion).
134134

135135
1. [Review the flag](#review-flag).
136-
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.
136+
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.
137137
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)
@@ -190,7 +190,7 @@ This flag is created by **`@system`** when a post is detected as possibly spam b
190190
##### [If the post is malicious](#if-the-post-is-malicious-1)
191191

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

195195
---
196196

@@ -217,10 +217,10 @@ This flag is created by **`@system`** when a new user created a topic, and anoth
217217
##### [If the post is malicious](#if-the-post-is-malicious-2)
218218

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

226226
---
@@ -280,12 +280,12 @@ Mentions of relevant products or services of interest to the Arduino community a
280280

281281
1. Click the **⬤⬤⬤** icon at the bottom of the spam post.
282282
1. Click the **:black_flag:** icon.
283-
1. Click the **It's Spam** radio button.
283+
1. Click the "**It's Spam**" radio button.
284284
1. Click the **<kbd>Take Action... ▾</kbd>** button.
285-
1. From the dropdown menu, click **Suspend User**. The **"Suspend User"** dialog will open.
286-
1. From the **Suspend user until** dropdown menu, select **Forever**.
287-
1. In the **Suspension Reason** text field, enter "spam".
288-
1. From the **"What would you like to do with the associated post?"** dropdown menu, select **Delete the post**.
285+
1. From the dropdown menu, click "**Suspend User**". The **"Suspend User"** dialog will open.
286+
1. From the "**Suspend user until**" dropdown menu, select "**Forever**".
287+
1. In the "**Suspension Reason**" text field, enter "spam".
288+
1. From the **"What would you like to do with the associated post?"** dropdown menu, select "**Delete the post**".
289289
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.
@@ -352,7 +352,7 @@ If multiple cross-posts have valuable replies, they must be preserved by merging
352352
1. Open the cross-post's topic.
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.
355-
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.
355+
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.
356356
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`.
358358
1. Click the **<kbd>Move to Existing Topic</kbd>** button.
@@ -613,7 +613,7 @@ Detailed information about Trust Levels: https://blog.discourse.org/2018/06/unde
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.
615615
1. Click the **<kbd>Admin</kbd>** button.
616-
1. From the **Permissions** section, click the **Trust Level** dropdown menu.
616+
1. From the "**Permissions**" section, click the "**Trust Level**" dropdown menu.
617617
1. Select the desired level from the menu.
618618
1. Click the **<kbd>:heavy_check_mark:</kbd>** button.
619619
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.
@@ -635,9 +635,9 @@ The "Silence" action is used in cases where the intent is to temporarily curtail
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.
637637
1. Click the **<kbd>Admin</kbd>** button.
638-
1. From the **Permissions** section, click the **<kbd>Silence</kbd>** button.
639-
1. From the **Select a timeframe** dropdown menu, select the desired duration of the silencing.
640-
1. In the **Silence Reason** text field, enter a short explanation for the cause for the silencing.
638+
1. From the "**Permissions**" section, click the <kbd>**Silence**</kbd> button.
639+
1. From the "**Select a timeframe**" dropdown menu, select the desired duration of the silencing.
640+
1. In the "**Silence Reason**" text field, enter a short explanation for the cause for the silencing.
641641
1. Click the **<kbd>Silence</kbd>** button.
642642

643643
---
@@ -662,9 +662,9 @@ Account suspensions are used when the intention is to permanently exclude the us
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.
664664
1. Click the **<kbd>Admin</kbd>** button.
665-
1. From the **Permissions** section, click the **<kbd>:no_entry_sign: Suspend</kbd>** button.
666-
1. From the **Suspend user until** dropdown menu, select **Forever**.
667-
1. In the **Suspension Reason** text field, enter a short explanation for the cause of suspension (e.g., "spam").
665+
1. From the "**Permissions**" section, click the <kbd>**🛇 Suspend**</kbd> button.
666+
1. From the "**Suspend user until**" dropdown menu, select "**Forever**".
667+
1. In the "**Suspension Reason**" text field, enter a short explanation for the cause of suspension (e.g., "spam").
668668
1. Click the **<kbd>:no_entry_sign: Suspend</kbd>** button.
669669

670670
---

0 commit comments

Comments
 (0)