Skip to content

Commit 54cb9ec

Browse files
committed
Add line breaks to improve readability of lists in "Moderator Instructions"
The "Moderator Instructions" asset post consists largely of instructions in the form of ordered lists. The first line of the step should contain only the essential information. Supplemental information must be placed on subsequent lines so that it can easily be skipped over by those who are already knowledgeable on the subject.
1 parent d60cfa5 commit 54cb9ec

File tree

1 file changed

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

1 file changed

+58
-27
lines changed

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

Lines changed: 58 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -81,9 +81,13 @@ When submitting a flag, the user selects the category of the reason for the flag
8181

8282
The ["**Review**" page](https://forum.arduino.cc/review) presents four options for handling user-submitted flags:
8383

84-
- **Yes ▾** - the flag was correct and the post was in violation of forum rules. The author of the flagged post will be [penalized](https://blog.discourse.org/2018/06/understanding-discourse-trust-levels/).
85-
- **No** - the flag was incorrect. The user who submitted the flag will be penalized.
86-
- **Ignore ▾** - the flag was correct, but didn't indicate a problem with the flagged post. Nobody is penalized. If the post was automatically hidden by the flag, it will remain hidden.
84+
- **Yes ▾** - the flag was correct and the post was in violation of forum rules.
85+
The author of the flagged post will be [penalized](https://blog.discourse.org/2018/06/understanding-discourse-trust-levels/).
86+
- **No** - the flag was incorrect.
87+
The user who submitted the flag will be penalized.
88+
- **Ignore ▾** - the flag was correct, but didn't indicate a problem with the flagged post.
89+
Nobody is penalized.
90+
If the post was automatically hidden by the flag, it will remain hidden.
8791

8892
---
8993

@@ -118,7 +122,8 @@ See the ["**Inappropriate behavior**" instructions](#deal-with-inappropriate-beh
118122
##### [If the post is spam](#if-the-post-is-spam)
119123

120124
1. Click the <kbd>**Yes ▾**</kbd> button.
121-
1. From the dropdown menu, click "**Suspend user**". The "**Suspend User**" dialog will open.
125+
1. From the dropdown menu, click "**Suspend user**".
126+
The "**Suspend User**" dialog will open.
122127
1. From the "**Suspend user until**" dropdown menu, select "**Forever**".
123128
1. In the "**Suspension Reason**" text field, enter "spam".
124129
1. From the "**What would you like to do with the associated post?**" dropdown menu, select "**Delete the post**".
@@ -133,7 +138,8 @@ See the ["**Inappropriate behavior**" instructions](#deal-with-inappropriate-beh
133138
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).
134139

135140
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.
141+
1. If the flag warranted action, resolve it, following the relevant instructions provided elsewhere in this document.
142+
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.
137143
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.
138144

139145
![Archive message|356x500, 50%](https://europe1.discourse-cdn.com/arduino/original/4X/0/e/c/0ec0938faf6e77029655ff167701d3ca16bbdd3f.png)
@@ -217,7 +223,8 @@ This flag is created by **`@system`** when a new user created a topic, and anoth
217223
##### [If the post is malicious](#if-the-post-is-malicious-2)
218224

219225
1. Click the <kbd>**Yes ▾**</kbd> button.
220-
1. From the dropdown menu, click "**Suspend User**". The "**Suspend User**" dialog will open.
226+
1. From the dropdown menu, click "**Suspend User**".
227+
The "**Suspend User**" dialog will open.
221228
1. From the "**Select a timeframe**" dropdown menu, select "**Forever**".
222229
1. In the "**Suspension Reason**" text field, enter "malicious use of multiple accounts".
223230
1. From the "**What would you like to do with the associated post?**" dropdown menu, select "**Delete the post**".
@@ -282,7 +289,8 @@ Mentions of relevant products or services of interest to the Arduino community a
282289
1. Click the **:black_flag:** icon.
283290
1. Click the "**It's Spam**" radio button.
284291
1. Click the <kbd>**Take Action... ▾**</kbd> button.
285-
1. From the dropdown menu, click "**Suspend User**". The "**Suspend User**" dialog will open.
292+
1. From the dropdown menu, click "**Suspend User**".
293+
The "**Suspend User**" dialog will open.
286294
1. From the "**Suspend user until**" dropdown menu, select "**Forever**".
287295
1. In the "**Suspension Reason**" text field, enter "spam".
288296
1. From the "**What would you like to do with the associated post?**" dropdown menu, select "**Delete the post**".
@@ -303,7 +311,8 @@ The Arduino Forum has [dedicated categories for several common non-English langu
303311

304312
Topics written in a language for which there is not a dedicated board may be left in the appropriate English language board.
305313

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.
314+
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).
315+
This will detect the language and allow you to determine the subject matter.
307316
**Note:** it's easy for someone unfamiliar with the language to mistake Portuguese for Spanish.
308317
1. Follow the ["**Move topic to correct category**" instructions](#move-topic-to-correct-category) to move the topic to the appropriate category.
309318

@@ -315,11 +324,14 @@ Topics written in a language for which there is not a dedicated board may be lef
315324

316325
A cross-post is when a user posts on the same subject to the forum multiple times. This is harmful because it can lead to wasting the time of people trying to help by unknowingly duplicating the efforts that were made previously in reply to another instance of the cross-post.
317326

318-
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.
319-
1. Click the **"Activity"** tab to see their posts.
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.
327+
1. Open the user's profile page.
328+
This can be accessed by clicking their user name, then the user name in the profile preview popup.
329+
1. Click the "**Activity**" tab to see their posts.
330+
1. Pick one of the cross-posts to keep.
331+
If only one cross-post has valuable replies, keep that one. The cross-post that is in the appropriate forum board has preference.
321332
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.
333+
1. Add a "[**User Note**](#add-user-note)" to document the rule violation.
334+
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.
323335
1. In a reply to the cross-post to be kept, add a ["Staff Post"](#make-staff-post):
324336
> I've deleted/merged your other cross-post(s).
325337
>
@@ -351,10 +363,18 @@ If multiple cross-posts have valuable replies, they must be preserved by merging
351363

352364
1. Open the cross-post's topic.
353365
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.
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.
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`.
366+
1. From the menu, select "**Select Posts...**".
367+
A "**You have selected 0 posts.**" dialog will open.
368+
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.
369+
1. Click the <kbd>**move to**</kbd> button.
370+
A "**Move to**" dialog will open.
371+
1. Use the "**Search for a Topic**" field to find the cross-post topic to be kept.
372+
This can be done by entering its topic ID, which is the number at the end of the topic's URL.
373+
For example, the ID of this topic:
374+
```text
375+
https://forum.arduino.cc/t/moderator-instructions/630548
376+
```
377+
is `630548`
358378
1. Click the <kbd>**Move to Existing Topic**</kbd> button.
359379

360380
---
@@ -377,12 +397,15 @@ A topic hijack is when a user makes a reply that is not relevant to the topic. T
377397

378398
1. Open the hijacked topic.
379399
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.
400+
1. From the menu, select "**Select Posts...**".
401+
A "**You have selected 0 posts.**" dialog will open.
381402
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.
403+
1. Click the <kbd>**move to**</kbd> button.
404+
A "**Move to**" dialog will open.
383405
1. In the "**New Topic Title**" field, enter an appropriate title for the subject of the hijack post.
384406
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.
407+
1. Click the <kbd>**Move to New Topic**</kbd> button.
408+
The new topic will be created and opened in your browser.
386409
1. In a reply to the newly created topic, add a ["Staff Post"](#make-staff-post):
387410
> Please don't hijack topics. I've had to split your post out to its own topic.
388411
>
@@ -516,7 +539,8 @@ This is the tool used by staff and automated systems to store documentation rela
516539

517540
This shows the user's posts, which can be used to find unreported inappropriate behavior (e.g., cross-posting, [spam](#delete-spam)).
518541

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.
542+
1. Open the user's profile page.
543+
This can be accessed by clicking their user name, then the user name in the profile preview popup.
520544
- 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.
521545
- Click the "**Activity**" tab to see their other posts.
522546

@@ -526,7 +550,8 @@ This shows the user's posts, which can be used to find unreported inappropriate
526550

527551
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)).
528552

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.
553+
1. Open the user's profile page.
554+
This can be accessed by clicking their user name, then the user name in the profile preview popup.
530555
1. Click the <kbd>**Admin**</kbd> button.
531556
1. Click the <kbd>**:globe_with_meridians: IP Lookup**</kbd> button.
532557
1. Check whether any other accounts are listed under the "**Other accounts with this IP address**" section.
@@ -537,7 +562,8 @@ This tool allows you to see all the accounts associated with the user's [IP addr
537562

538563
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.
539564

540-
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.
565+
1. Open the user's profile page.
566+
This can be accessed by clicking their user name, then the user name in the profile preview popup.
541567
1. Click the <kbd>**Admin**</kbd> button.
542568
1. Click the <kbd>**Action Logs**</kbd> button.
543569

@@ -577,8 +603,10 @@ User notes can be associated with a post. These are the same as the [User Notes
577603

578604
#### [User Notes general to an account](#user-notes-general-to-an-account)
579605

580-
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.
606+
1. Open the user's profile page.
607+
This can be accessed by clicking their user name, then the user name in the profile preview popup.
608+
1. Click the <kbd>**User Notes**</kbd> button.
609+
The user notes will be displayed, as well as a field for adding new notes.
582610
1. Write the User Note.
583611
1. Click the <kbd>**Add User Note**</kbd> button.
584612

@@ -611,7 +639,8 @@ The user's privileges on the forum are dependent on their "Trust Level" (TL). Th
611639

612640
Detailed information about Trust Levels: https://blog.discourse.org/2018/06/understanding-discourse-trust-levels/
613641

614-
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.
642+
1. Open the user's profile page.
643+
This can be accessed by clicking their user name, then the user name in the profile preview popup.
615644
1. Click the <kbd>**Admin**</kbd> button.
616645
1. From the "**Permissions**" section, click the "**Trust Level**" dropdown menu.
617646
1. Select the desired level from the menu.
@@ -633,7 +662,8 @@ The "Silence" action is used in cases where the intent is to temporarily curtail
633662

634663
---
635664

636-
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.
665+
1. Open the user's profile page.
666+
This can be accessed by clicking their user name, then the user name in the profile preview popup.
637667
1. Click the <kbd>**Admin**</kbd> button.
638668
1. From the "**Permissions**" section, click the <kbd>**Silence**</kbd> button.
639669
1. From the "**Select a timeframe**" dropdown menu, select the desired duration of the silencing.
@@ -660,7 +690,8 @@ Account suspensions are used when the intention is to permanently exclude the us
660690

661691
---
662692

663-
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.
693+
1. Open the user's profile page.
694+
This can be accessed by clicking their user name, then the user name in the profile preview popup.
664695
1. Click the <kbd>**Admin**</kbd> button.
665696
1. From the "**Permissions**" section, click the <kbd>**🛇 Suspend**</kbd> button.
666697
1. From the "**Suspend user until**" dropdown menu, select "**Forever**".

0 commit comments

Comments
 (0)