You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Don't bold quoting of 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.
This is done by employing several formatting techniques:
- Bolding
- Quoting
Since the goal is only to emphasize the non-prose references, the quotes should not be bolded, so the nesting of the
formatting markup must be done in the correct order.
Some of the formatting was previously nested in the incorrect order, which resulted in inconsistent formatting and
harmed readability.
Copy file name to clipboardExpand all lines: content/categories/staff/moderation/_topics/moderator-instructions/1.md
+27-27Lines changed: 27 additions & 27 deletions
Original file line number
Diff line number
Diff line change
@@ -91,15 +91,15 @@ The ["**Review**" page](https://forum.arduino.cc/review) presents four options f
91
91
92
92
#### [Post flagged as "Off-Topic"](#post-flagged-as-off-topic)
93
93
94
-
See the [**"Move topic"**](#move-topic-to-correct-category) or [**"Split topic"**](#split-hijacked-topic) instructions.
94
+
See the "[**Move topic**](#move-topic-to-correct-category)" or "[**Split topic**](#split-hijacked-topic)" instructions.
95
95
96
96
---
97
97
98
98
<aname="post-flagged-as-inappropriate"></a>
99
99
100
100
#### [Post flagged as "Inappropriate"](#post-flagged-as-inappropriate)
101
101
102
-
See the [**"Inappropriate behavior"**](#deal-with-inappropriate-behavior) instructions.
102
+
See the ["**Inappropriate behavior**" instructions](#deal-with-inappropriate-behavior).
103
103
104
104
---
105
105
@@ -118,10 +118,10 @@ See the [**"Inappropriate behavior"**](#deal-with-inappropriate-behavior) instru
118
118
##### [If the post is spam](#if-the-post-is-spam)
119
119
120
120
1. Click the **<kbd>Yes ▾</kbd>** button.
121
-
1. From the dropdown menu, click "**Suspend user**". The **"Suspend User"** dialog will open.
121
+
1. From the dropdown menu, click "**Suspend user**". The "**Suspend User**" dialog will open.
122
122
1. From the "**Suspend user until**" dropdown menu, select "**Forever**".
123
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**".
124
+
1. From the "**What would you like to do with the associated post?**" dropdown menu, select "**Delete the post**".
125
125
1. Click the **<kbd>:no_entry_sign: Suspend</kbd>** button.
126
126
127
127
---
@@ -133,12 +133,12 @@ See the [**"Inappropriate behavior"**](#deal-with-inappropriate-behavior) instru
133
133
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).
134
134
135
135
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.
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.
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.
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.
**WARNING:** the [**"Moderators"** messages folder](https://forum.arduino.cc/my/messages/group/moderators) is shared between all the moderators. When you take an action it affects the inbox for everyone.
141
+
**WARNING:** the ["**Moderators**" messages folder](https://forum.arduino.cc/my/messages/group/moderators) is shared between all the moderators. When you take an action it affects the inbox for everyone.
142
142
143
143
---
144
144
@@ -217,10 +217,10 @@ This flag is created by **`@system`** when a new user created a topic, and anoth
217
217
##### [If the post is malicious](#if-the-post-is-malicious-2)
218
218
219
219
1. Click the **<kbd>Yes ▾</kbd>** button.
220
-
1. From the dropdown menu, click "**Suspend User**". The **"Suspend User"** dialog will open.
220
+
1. From the dropdown menu, click "**Suspend User**". The "**Suspend User**" dialog will open.
221
221
1. From the "**Select a timeframe**" dropdown menu, select "**Forever**".
222
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**".
223
+
1. From the "**What would you like to do with the associated post?**" dropdown menu, select "**Delete the post**".
224
224
1. Click the **<kbd>:no_entry_sign: Suspend</kbd>** button.
225
225
226
226
---
@@ -282,16 +282,16 @@ Mentions of relevant products or services of interest to the Arduino community a
282
282
1. Click the **:black_flag:** icon.
283
283
1. Click the "**It's Spam**" radio button.
284
284
1. Click the **<kbd>Take Action... ▾</kbd>** button.
285
-
1. From the dropdown menu, click "**Suspend User**". The **"Suspend User"** dialog will open.
285
+
1. From the dropdown menu, click "**Suspend User**". The "**Suspend User**" dialog will open.
286
286
1. From the "**Suspend user until**" dropdown menu, select "**Forever**".
287
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**".
288
+
1. From the "**What would you like to do with the associated post?**" dropdown menu, select "**Delete the post**".
289
289
1. Click the **<kbd>:no_entry_sign: Suspend</kbd>** button.
290
290
1. Click the spammer's user name.
291
291
1. Click the spammer's user name in the profile preview popup.
292
-
1. Click the **"Activity"** tab to see their other posts.
292
+
1. Click the "**Activity**" tab to see their other posts.
293
293
1. Open any other spam posts they have made.
294
-
1. Follow the [**"Delete post"**](#delete-post) or [**"Delete topic"**](#delete-topic) instructions to delete the additional spam.
294
+
1. Follow the "[**Delete post**](#delete-post)" or "[**Delete topic**](#delete-topic)" instructions to delete the additional spam.
295
295
296
296
---
297
297
@@ -305,7 +305,7 @@ Topics written in a language for which there is not a dedicated board may be lef
305
305
306
306
1. If you don't know the language or, in the case of language categories with sub-categories, subject, copy the post text and paste it into [**Google Translate**](https://translate.google.com). This will detect the language and allow you to determine the subject matter.
307
307
**Note:** it's easy for someone unfamiliar with the language to mistake Portuguese for Spanish.
308
-
1. Follow the **["Move topic to correct category" instructions](#move-topic-to-correct-category)** to move the topic to the appropriate category.
308
+
1. Follow the ["**Move topic to correct category**" instructions](#move-topic-to-correct-category) to move the topic to the appropriate category.
309
309
310
310
---
311
311
@@ -319,7 +319,7 @@ A cross-post is when a user posts on the same subject to the forum multiple time
319
319
1. Click the **"Activity"** tab to see their posts.
320
320
1. Pick one of the cross-posts to keep. If only one cross-post has valuable replies, keep that one. The cross-post that is in the appropriate forum board has preference.
321
321
1. Follow the instructions below to [delete](#if-the-post-to-be-removed-has-no-valuable-replies) or [merge](#if-the-post-to-be-removed-has-valuable-replies) the other cross-posts.
322
-
1. Add a [**"User Note"**](#add-user-note) to document the rule violation. If the user notes indicate a history of repeated cross-posting, take more severe moderation action, as described in the [**"Deal with inappropriate behavior"**](#deal-with-inappropriate-behavior) instructions.
322
+
1. Add a "[**User Note**](#add-user-note)" to document the rule violation. If the user notes indicate a history of repeated cross-posting, take more severe moderation action, as described in the "[**Deal with inappropriate behavior**](#deal-with-inappropriate-behavior)" instructions.
323
323
1. In a reply to the cross-post to be kept, add a ["Staff Post"](#make-staff-post):
324
324
> I've deleted/merged your other cross-post(s).
325
325
>
@@ -335,7 +335,7 @@ A cross-post is when a user posts on the same subject to the forum multiple time
335
335
336
336
##### [If the post to be removed has no valuable replies](#if-the-post-to-be-removed-has-no-valuable-replies)
337
337
338
-
1. Follow the [**"Delete post"**](#delete-post) or [**"Delete topic"**](#delete-topic) instructions.
338
+
1. Follow the "[**Delete post**](#delete-post)" or "[**Delete topic**](#delete-topic)" instructions.
@@ -351,9 +351,9 @@ If multiple cross-posts have valuable replies, they must be preserved by merging
351
351
352
352
1. Open the cross-post's topic.
353
353
1. Click the wrench button ("topic actions") at the bottom of the topic.
354
-
1. From the menu, select "**Select Posts...**". A **"You have selected 0 posts."** dialog will open.
354
+
1. From the menu, select "**Select Posts...**". A "**You have selected 0 posts.**" dialog will open.
355
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.
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.
357
357
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
358
1. Click the **<kbd>Move to Existing Topic</kbd>** button.
359
359
@@ -371,17 +371,17 @@ A topic hijack is when a user makes a reply that is not relevant to the topic. T
371
371
372
372
---
373
373
374
-
**Note:** cross-posts are sometimes done in the form of a hijack. In that case, follow the [**"Deal with cross-post"** instructions](#deal-with-cross-post).
374
+
**Note:** cross-posts are sometimes done in the form of a hijack. In that case, follow the ["**Deal with cross-post**" instructions](#deal-with-cross-post).
375
375
376
376
---
377
377
378
378
1. Open the hijacked topic.
379
379
1. Click the wrench button ("topic actions") at the bottom of the topic.
380
-
1. From the menu, select "**Select Posts...**". A **"You have selected 0 posts."** dialog will open.
380
+
1. From the menu, select "**Select Posts...**". A "**You have selected 0 posts.**" dialog will open.
381
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.
383
-
1. In the **"New Topic Title"** field, enter an appropriate title for the subject of the hijack post.
384
-
1. Select the appropriate [forum category](https://forum.arduino.cc/categories) from the **"Category"** dropdown menu.
382
+
1. Click the **<kbd>move to</kbd>** button. A "**Move to**" dialog will open.
383
+
1. In the "**New Topic Title**" field, enter an appropriate title for the subject of the hijack post.
384
+
1. Select the appropriate [forum category](https://forum.arduino.cc/categories) from the "**Category**" dropdown menu.
385
385
1. Click the **<kbd>Move to New Topic</kbd>** button. The new topic will be created and opened in your browser.
386
386
1. In a reply to the newly created topic, add a ["Staff Post"](#make-staff-post):
387
387
> Please don't hijack topics. I've had to split your post out to its own topic.
@@ -518,7 +518,7 @@ This shows the user's posts, which can be used to find unreported inappropriate
518
518
519
519
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.
520
520
- If any of their posts have been deleted, there will be a black bar at the top of the user profile "**Summary**" page with a "**deleted posts**" link. Click that link to see the deleted posts.
521
-
- Click the **"Activity"** tab to see their other posts.
521
+
- Click the "**Activity**" tab to see their other posts.
522
522
523
523
<aname="ip-lookup"></a>
524
524
@@ -529,7 +529,7 @@ This tool allows you to see all the accounts associated with the user's [IP addr
529
529
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
530
1. Click the **<kbd>Admin</kbd>** button.
531
531
1. Click the **<kbd>:globe_with_meridians: IP Lookup</kbd>** button.
532
-
1. Check whether any other accounts are listed under the **"Other accounts with this IP address"** section.
532
+
1. Check whether any other accounts are listed under the "**Other accounts with this IP address**" section.
533
533
534
534
<aname="action-logs"></a>
535
535
@@ -567,7 +567,7 @@ User notes can be associated with a post. These are the same as the [User Notes
567
567
568
568
1. Click the **⬤⬤⬤** icon at the bottom of the post.
569
569
1. Click the wrench icon.
570
-
1. Click **"Add User Note"**.
570
+
1. Click "**Add User Note**".
571
571
1. Write the User Note.
572
572
1. Click the **<kbd>Add User Note</kbd>** button.
573
573
@@ -599,7 +599,7 @@ Moderators can mark their posts with a "Staff Color", which is intended to give
599
599
1. Make a post as usual, whether that be a topic or reply.
600
600
1. Click the **⬤⬤⬤** icon at the bottom of the post to be given the "Staff Color".
0 commit comments