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
Use standardized symbols to indicate nature of admonitions in "Moderator Instructions"
One of the elements used in the content of the "Moderator Instructions" asset post is "admonitions". These contain
information related to the surrounding content, formatted in a manner that makes them visually distinctive.
"Admonitions" fall into three general categories:
- Supplements: Additional information to help the reader to understand more about the subject
- Notices: Important information the reader should be aware of
- Warnings: Something bad can happen if an instruction is not performed correctly
In order to provide a clear visual indication of the type of an admonition, it is prefixed by a standardized symbolic
character.
Copy file name to clipboardExpand all lines: content/categories/staff/moderation/_topics/moderator-instructions/1.md
+22-22Lines changed: 22 additions & 22 deletions
Original file line number
Diff line number
Diff line change
@@ -63,7 +63,7 @@ Flags are shown on the ["**Review**" page](https://forum.arduino.cc/review). A m
63
63
64
64
---
65
65
66
-
**Note:** there are some conditions where mention of products or services is allowed and not considered spam, which are listed [**here**](#exceptions).
66
+
❗ There are some conditions where mention of products or services is allowed and not considered spam, which are listed [**here**](#exceptions).
67
67
68
68
---
69
69
@@ -144,7 +144,7 @@ The user submitting a "**Something Else**" flag will provide a message explainin
**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.
147
+
⚠ 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.
148
148
149
149
---
150
150
@@ -313,7 +313,7 @@ Topics written in a language for which there is not a dedicated board may be lef
313
313
314
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
315
This will detect the language and allow you to determine the subject matter.
316
-
**Note:** it's easy for someone unfamiliar with the language to mistake Portuguese for Spanish.
316
+
❗ It's easy for someone unfamiliar with the language to mistake Portuguese for Spanish.
317
317
1. Follow the ["**Move topic to correct category**" instructions](#move-topic-to-correct-category) to move the topic to the appropriate category.
318
318
319
319
---
@@ -325,7 +325,7 @@ Topics written in a language for which there is not a dedicated board may be lef
325
325
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.
326
326
327
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.
328
+
**ⓘ**This can be accessed by clicking their user name, then the user name in the profile preview popup.
329
329
1. Click the "**Activity**" tab to see their posts.
330
330
1. Pick one of the cross-posts to keep.
331
331
If only one cross-post has valuable replies, keep that one. The cross-post that is in the appropriate forum board has preference.
@@ -357,7 +357,7 @@ If multiple cross-posts have valuable replies, they must be preserved by merging
357
357
358
358
---
359
359
360
-
**Note:** The moved posts will be appended to the end of the thread of the topic they are moved to, regardless of the chronology of the posts.
360
+
⚠ The moved posts will be appended to the end of the thread of the topic they are moved to, regardless of the chronology of the posts.
361
361
362
362
---
363
363
@@ -387,11 +387,11 @@ A topic hijack is when a user makes a reply that is not relevant to the topic. T
387
387
388
388
---
389
389
390
-
**Note:** a relevant reply to an old topic is not considered a hijack.
390
+
❗ A relevant reply to an old topic is not considered a hijack.
391
391
392
392
---
393
393
394
-
**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).
394
+
**ⓘ**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).
395
395
396
396
---
397
397
@@ -436,7 +436,7 @@ When a reopen request flag is received, it should be reviewed to determine wheth
436
436
1. Click the <kbd>**:email: Message**</kbd> button.
437
437
1. Go back to [the flag review page](https://forum.arduino.cc/review).
438
438
1. Click the <kbd>**Ignore ▾**</kbd> button on the flag message.
439
-
**Note:** the <kbd>**Yes ▾**</kbd> button should not be used because this would result in an unwarranted strike against the topic author.
439
+
⚠ the <kbd>**Yes ▾**</kbd> button should not be used because this would result in an unwarranted strike against the topic author.
440
440
441
441
##### If reopening is not appropriate
442
442
@@ -488,7 +488,7 @@ Users often create topics in [categories](https://forum.arduino.cc/categories) w
488
488
489
489
---
490
490
491
-
**Note:** be careful not to accidentally [delete the topic](#delete-topic) when you intended instead to only delete the last reply in the thread.
491
+
⚠ Be careful not to accidentally [delete the topic](#delete-topic) when you intended instead to only delete the last reply in the thread.
492
492
493
493
---
494
494
@@ -526,7 +526,7 @@ This is the tool used by staff and automated systems to store documentation rela
526
526
527
527
---
528
528
529
-
**Note:** User Notes are generated by [flags](#automated-system-submitted-flags) submitted by automated systems. These flags are regularly false positives. So be cautious in assigning importance to User Notes written by the **`@system`** user.
529
+
❗ User Notes are generated by [flags](#automated-system-submitted-flags) submitted by automated systems. These flags are regularly false positives. So be cautious in assigning importance to User Notes written by the **`@system`** user.
530
530
531
531
---
532
532
@@ -540,7 +540,7 @@ This is the tool used by staff and automated systems to store documentation rela
540
540
This shows the user's posts, which can be used to find unreported inappropriate behavior (e.g., cross-posting, [spam](#delete-spam)).
541
541
542
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.
543
+
**ⓘ**This can be accessed by clicking their user name, then the user name in the profile preview popup.
544
544
- 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.
545
545
- Click the "**Activity**" tab to see their other posts.
546
546
@@ -551,7 +551,7 @@ This shows the user's posts, which can be used to find unreported inappropriate
551
551
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)).
552
552
553
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.
554
+
**ⓘ**This can be accessed by clicking their user name, then the user name in the profile preview popup.
555
555
1. Click the <kbd>**Admin**</kbd> button.
556
556
1. Click the <kbd>**:globe_with_meridians: IP Lookup**</kbd> button.
557
557
1. Check whether any other accounts are listed under the "**Other accounts with this IP address**" section.
@@ -563,7 +563,7 @@ This tool allows you to see all the accounts associated with the user's [IP addr
563
563
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.
564
564
565
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.
566
+
**ⓘ**This can be accessed by clicking their user name, then the user name in the profile preview popup.
567
567
1. Click the <kbd>**Admin**</kbd> button.
568
568
1. Click the <kbd>**Action Logs**</kbd> button.
569
569
@@ -577,7 +577,7 @@ This shows all staff actions that affected the user's account. The [User Notes](
577
577
578
578
---
579
579
580
-
**Note:**only moderators and administrators can see the icon and the notes. They are not visible to regular users.
580
+
**ⓘ**Only moderators and administrators can see the icon and the notes. They are not visible to regular users.
581
581
582
582
---
583
583
@@ -604,7 +604,7 @@ User notes can be associated with a post. These are the same as the [User Notes
604
604
#### [User Notes general to an account](#user-notes-general-to-an-account)
605
605
606
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.
607
+
**ⓘ**This can be accessed by clicking their user name, then the user name in the profile preview popup.
608
608
1. Click the <kbd>**User Notes**</kbd> button.
609
609
The user notes will be displayed, as well as a field for adding new notes.
610
610
1. Write the User Note.
@@ -620,7 +620,7 @@ Moderators can mark their posts with a "Staff Color", which is intended to give
620
620
621
621
---
622
622
623
-
**Note:**this is not the same as the similarly named "Staff Notice". Due to serving no useful purpose, "Staff Notices" should not be used.
623
+
**ⓘ**This is not the same as the similarly named "Staff Notice". Due to serving no useful purpose, "Staff Notices" should not be used.
624
624
625
625
---
626
626
@@ -640,7 +640,7 @@ The user's privileges on the forum are dependent on their "Trust Level" (TL). Th
640
640
Detailed information about Trust Levels: https://blog.discourse.org/2018/06/understanding-discourse-trust-levels/
641
641
642
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.
643
+
**ⓘ**This can be accessed by clicking their user name, then the user name in the profile preview popup.
644
644
1. Click the <kbd>**Admin**</kbd> button.
645
645
1. From the "**Permissions**" section, click the "**Trust Level**" dropdown menu.
646
646
1. Select the desired level from the menu.
@@ -658,12 +658,12 @@ The "Silence" action is used in cases where the intent is to temporarily curtail
658
658
659
659
---
660
660
661
-
**Note:** in cases where the intent is to permanently exclude the user from the Arduino Forum, the account should instead be ["Suspended"](#suspend-an-account).
661
+
❗ In cases where the intent is to permanently exclude the user from the Arduino Forum, the account should instead be ["Suspended"](#suspend-an-account).
662
662
663
663
---
664
664
665
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.
666
+
**ⓘ**This can be accessed by clicking their user name, then the user name in the profile preview popup.
667
667
1. Click the <kbd>**Admin**</kbd> button.
668
668
1. From the "**Permissions**" section, click the <kbd>**Silence**</kbd> button.
669
669
1. From the "**Select a timeframe**" dropdown menu, select the desired duration of the silencing.
@@ -682,16 +682,16 @@ Account suspensions are used when the intention is to permanently exclude the us
682
682
683
683
---
684
684
685
-
**Note:** in cases where the intent is to temporarily curtail a user's forum activity in response to [inappropriate behavior](#deal-with-inappropriate-behavior), with the intent to later restore their privileges in hopes they can be reformed to a responsible member of the forum community, they should instead be ["Silenced"](#silence-user).
685
+
❗ in cases where the intent is to temporarily curtail a user's forum activity in response to [inappropriate behavior](#deal-with-inappropriate-behavior), with the intent to later restore their privileges in hopes they can be reformed to a responsible member of the forum community, they should instead be ["Silenced"](#silence-user).
686
686
687
687
---
688
688
689
-
**Note:** Arduino has [a policy](https://forum.arduino.cc/t/about-user-account-deletion-and-user-content-deletion/627095/5) against deleting accounts, so you must not use the **Delete User** options the Discourse moderator interface often presents. Account suspensions are used instead. Suspensions are reversible in the event an error was discovered, which allows the moderators more freedom to take swift action.
689
+
⚠ Arduino has [a policy](https://forum.arduino.cc/t/about-user-account-deletion-and-user-content-deletion/627095/5) against deleting accounts, so you must not use the **Delete User** options the Discourse moderator interface often presents. Account suspensions are used instead. Suspensions are reversible in the event an error was discovered, which allows the moderators more freedom to take swift action.
690
690
691
691
---
692
692
693
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.
694
+
**ⓘ**This can be accessed by clicking their user name, then the user name in the profile preview popup.
695
695
1. Click the <kbd>**Admin**</kbd> button.
696
696
1. From the "**Permissions**" section, click the <kbd>**🛇 Suspend**</kbd> button.
697
697
1. From the "**Suspend user until**" dropdown menu, select "**Forever**".
0 commit comments