Bold non-prose references in "Moderator Instructions"

per1234 · per1234 · commit 4c6fec668f85 · 2023-04-17T14:52:11.000-07:00
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 can be accomplished by making these types of non-prose text bold.

That formatting convention was already employed in the document, but was missing in some places. The formatting is
hereby done consistently throughout the document.
diff --git a/content/categories/staff/moderation/_topics/moderator-instructions/1.md b/content/categories/staff/moderation/_topics/moderator-instructions/1.md
@@ -1,6 +1,6 @@
 These are instructions for common moderation actions.
 
-For general moderation guidelines, see the ["Moderator Guidelines" topic](https://forum.arduino.cc/t/moderation-guidelines/54905).
+For general moderation guidelines, see the ["**Moderator Guidelines**" topic](https://forum.arduino.cc/t/moderation-guidelines/54905).
 
 For an overview of the Discourse moderation system, see the **[Discourse Moderation Guide](https://meta.discourse.org/t/discourse-moderation-guide/63116)**.
 
@@ -59,11 +59,11 @@ For an overview of the Discourse moderation system, see the **[Discourse Moderat
 
 Flags are used to bring things to the attention of the moderators. They may be submitted [by forum users](#user-submitted-flags) or [by automated systems](#automated-system-submitted-flags).
 
-Flags are shown on the ["Review" page](https://forum.arduino.cc/review). A moderator must review each flag and decide how it should be handled.
+Flags are shown on the ["**Review**" page](https://forum.arduino.cc/review). A moderator must review each flag and decide how it should be handled.
 
 ---
 
-**Note:** there are some conditions where mention of products or services is allowed and not considered spam, which are listed [here](#exceptions).
+**Note:** there are some conditions where mention of products or services is allowed and not considered spam, which are listed [**here**](#exceptions).
 
 ---
 
@@ -79,7 +79,7 @@ When submitting a flag, the user selects the category of the reason for the flag
 
 #### [Review flag](#review-flag)
 
-The ["Review" page](https://forum.arduino.cc/review) presents four options for handling user-submitted flags:
+The ["**Review**" page](https://forum.arduino.cc/review) presents four options for handling user-submitted flags:
 
 - **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/).
 - **No** - the flag was incorrect. The user who submitted the flag will be penalized.
@@ -130,11 +130,11 @@ See the [**"Inappropriate behavior"**](#deal-with-inappropriate-behavior) instru
 
 #### [Post flagged as "Something Else"](#post-flagged-as-something-else)
 
-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).
+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).
 
 1. [Review the flag](#review-flag).
 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.
-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.
+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.
 
    ![Archive message|356x500, 50%](https://europe1.discourse-cdn.com/arduino/original/4X/0/e/c/0ec0938faf6e77029655ff167701d3ca16bbdd3f.png)
 
@@ -146,13 +146,13 @@ The user submitting a "Something Else" flag will provide a message explaining th
 
 ### [Automated system-submitted flags](#automated-system-submitted-flags)
 
-The forum software does automated detection of potentially malicious user accounts or posts. These are submitted by the `@system` user.
+The forum software does automated detection of potentially malicious user accounts or posts. These are submitted by the **`@system`** user.
 
 <a name="needs-approval-flag-for-account"></a>
 
 #### ["Needs Approval" flag for account](#needs-approval-flag-for-account)
 
-This flag is created by `@system` when a user account creation is detected as possibly malicious. The account must be reviewed by a moderator.
+This flag is created by **`@system`** when a user account creation is detected as possibly malicious. The account must be reviewed by a moderator.
 
 <a name="if-the-account-is-benign"></a>
 
@@ -177,7 +177,7 @@ Please note that Arduino has a firm policy against deleting any accounts, so you
 
 #### [Akismet flagged post](#akismet-flagged-post)
 
-This flag is created by `@system` when a post is detected as possibly spam by [Akismet](https://en.wikipedia.org/wiki/Akismet). The post must be reviewed by a moderator.
+This flag is created by **`@system`** when a post is detected as possibly spam by [**Akismet**](https://en.wikipedia.org/wiki/Akismet). The post must be reviewed by a moderator.
 
 <a name="if-the-post-is-benign-1"></a>
 
@@ -198,7 +198,7 @@ This flag is created by `@system` when a post is detected as possibly spam by [A
 
 #### ["flag_sockpuppets" flag](#sockpuppets-flag)
 
-This flag is created by `@system` when a new user created a topic, and another new user at the same IP address replied. The flagged post must be reviewed by a moderator.
+This flag is created by **`@system`** when a new user created a topic, and another new user at the same IP address replied. The flagged post must be reviewed by a moderator.
 
 ---
 
@@ -271,7 +271,7 @@ In addition to the reports via [flags](#flags), you may also encounter spam whil
 
 Mentions of relevant products or services of interest to the Arduino community are allowed in:
 
-- Topics in the ["Products and Services" category](https://forum.arduino.cc/c/community/products-and-services/41).
+- Topics in the ["**Products and Services**" category](https://forum.arduino.cc/c/community/products-and-services/41).
 - Replies to topics in other [categories](https://forum.arduino.cc/categories) when the intent is to benefit the discussion, rather than solely to advertise.
 
 <a name="instructions"></a>
@@ -303,7 +303,7 @@ The Arduino Forum has [dedicated categories for several common non-English langu
 
 Topics written in a language for which there is not a dedicated board may be left in the appropriate English language board.
 
-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.
+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.
    **Note:** it's easy for someone unfamiliar with the language to mistake Portuguese for Spanish.
 1. Follow the **["Move topic to correct category" instructions](#move-topic-to-correct-category)** to move the topic to the appropriate category.
 
@@ -396,7 +396,7 @@ A topic hijack is when a user makes a reply that is not relevant to the topic. T
 
 ### [Reopen auto-closed topic](#reopen-auto-closed-topic)
 
-When six months have passed since the last reply to a topic, it is automatically closed and non-staff forum users are prevented from replying. Forum users may request topics be unlocked by raising a "Something Else" flag against the topic.
+When six months have passed since the last reply to a topic, it is automatically closed and non-staff forum users are prevented from replying. Forum users may request topics be unlocked by raising a "**Something Else**" flag against the topic.
 
 When a reopen request flag is received, it should be reviewed to determine whether reopening the topic would be appropriate.
 
@@ -503,7 +503,7 @@ This is the tool used by staff and automated systems to store documentation rela
 
 ---
 
-**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.
+**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.
 
 ---
 
@@ -517,7 +517,7 @@ This is the tool used by staff and automated systems to store documentation rela
 This shows the user's posts, which can be used to find unreported inappropriate behavior (e.g., cross-posting, [spam](#delete-spam)).
 
 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.
-   - 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.
+   - 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.
    - Click the **"Activity"** tab to see their other posts.
 
 <a name="ip-lookup"></a>
@@ -675,9 +675,9 @@ Account suspensions are used when the intention is to permanently exclude the us
 
 Some additional information relevant to forum moderator procedures:
 
-- Glossary of terms: https://meta.discourse.org/t/discourse-new-user-guide/96331#basic-terms-used-by-discourse-nomenclature
-- Explanation of Trust Levels (TL): https://blog.discourse.org/2018/06/understanding-discourse-trust-levels/
-- Video about handling flags: https://meta.discourse.org/t/video-how-to-moderate-posts/136440
+- **Glossary of terms**: https://meta.discourse.org/t/discourse-new-user-guide/96331#basic-terms-used-by-discourse-nomenclature
+- **Explanation of Trust Levels (TL)**: https://blog.discourse.org/2018/06/understanding-discourse-trust-levels/
+- **Video about handling flags**: https://meta.discourse.org/t/video-how-to-moderate-posts/136440
 
 ---
 
