Skip to content

Commit b5b983a

Browse files
committed
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.
1 parent 54cb9ec commit b5b983a

File tree

1 file changed

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

1 file changed

+22
-22
lines changed

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

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ Flags are shown on the ["**Review**" page](https://forum.arduino.cc/review). A m
6363

6464
---
6565

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).
6767

6868
---
6969

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

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

147-
**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.
148148

149149
---
150150

@@ -313,7 +313,7 @@ Topics written in a language for which there is not a dedicated board may be lef
313313

314314
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).
315315
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.
317317
1. Follow the ["**Move topic to correct category**" instructions](#move-topic-to-correct-category) to move the topic to the appropriate category.
318318

319319
---
@@ -325,7 +325,7 @@ Topics written in a language for which there is not a dedicated board may be lef
325325
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.
326326

327327
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.
329329
1. Click the "**Activity**" tab to see their posts.
330330
1. Pick one of the cross-posts to keep.
331331
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
357357

358358
---
359359

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.
361361

362362
---
363363

@@ -387,11 +387,11 @@ A topic hijack is when a user makes a reply that is not relevant to the topic. T
387387

388388
---
389389

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.
391391

392392
---
393393

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).
395395

396396
---
397397

@@ -436,7 +436,7 @@ When a reopen request flag is received, it should be reviewed to determine wheth
436436
1. Click the <kbd>**:email: Message**</kbd> button.
437437
1. Go back to [the flag review page](https://forum.arduino.cc/review).
438438
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.
440440

441441
##### If reopening is not appropriate
442442

@@ -488,7 +488,7 @@ Users often create topics in [categories](https://forum.arduino.cc/categories) w
488488

489489
---
490490

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.
492492

493493
---
494494

@@ -526,7 +526,7 @@ This is the tool used by staff and automated systems to store documentation rela
526526

527527
---
528528

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.
530530

531531
---
532532

@@ -540,7 +540,7 @@ This is the tool used by staff and automated systems to store documentation rela
540540
This shows the user's posts, which can be used to find unreported inappropriate behavior (e.g., cross-posting, [spam](#delete-spam)).
541541

542542
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.
544544
- 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.
545545
- Click the "**Activity**" tab to see their other posts.
546546

@@ -551,7 +551,7 @@ This shows the user's posts, which can be used to find unreported inappropriate
551551
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)).
552552

553553
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.
555555
1. Click the <kbd>**Admin**</kbd> button.
556556
1. Click the <kbd>**:globe_with_meridians: IP Lookup**</kbd> button.
557557
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
563563
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.
564564

565565
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.
567567
1. Click the <kbd>**Admin**</kbd> button.
568568
1. Click the <kbd>**Action Logs**</kbd> button.
569569

@@ -577,7 +577,7 @@ This shows all staff actions that affected the user's account. The [User Notes](
577577

578578
---
579579

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.
581581

582582
---
583583

@@ -604,7 +604,7 @@ User notes can be associated with a post. These are the same as the [User Notes
604604
#### [User Notes general to an account](#user-notes-general-to-an-account)
605605

606606
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.
608608
1. Click the <kbd>**User Notes**</kbd> button.
609609
The user notes will be displayed, as well as a field for adding new notes.
610610
1. Write the User Note.
@@ -620,7 +620,7 @@ Moderators can mark their posts with a "Staff Color", which is intended to give
620620

621621
---
622622

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.
624624

625625
---
626626

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

642642
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.
644644
1. Click the <kbd>**Admin**</kbd> button.
645645
1. From the "**Permissions**" section, click the "**Trust Level**" dropdown menu.
646646
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
658658

659659
---
660660

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).
662662

663663
---
664664

665665
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.
667667
1. Click the <kbd>**Admin**</kbd> button.
668668
1. From the "**Permissions**" section, click the <kbd>**Silence**</kbd> button.
669669
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
682682

683683
---
684684

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).
686686

687687
---
688688

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.
690690

691691
---
692692

693693
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.
695695
1. Click the <kbd>**Admin**</kbd> button.
696696
1. From the "**Permissions**" section, click the <kbd>**🛇 Suspend**</kbd> button.
697697
1. From the "**Suspend user until**" dropdown menu, select "**Forever**".

0 commit comments

Comments
 (0)