code admin->blacklister; link training index; grammar; add comment po…

…licy

pings/index.md

@@ -6,7 +6,7 @@ When an organisation such as Charcoal is maintaining several large projects with
 
 ### In general - who has access to what {#general}
 
-If you're not sure who has access to which systems, the general rule is this: our six [admins](/people) have the vast majority of access to the vast majority of systems; you'll probably do well to ping one of them. If they don't know, they'll certainly know who to pass it on to. Beyond that, our three metasmoke developers (Undo, ArtOfCode, thesecretmaster) have even higher accesses to metasmoke systems, and Undo runs the system and has total control.
+If you're not sure who has access to which systems, the general rule is this: our six [admins](/people) have the vast majority of access to the vast majority of systems; you'll probably do well to ping one of them. If they don't know, they'll certainly know who to pass it on to. Beyond that, our four metasmoke developers (Undo, ArtOfCode, thesecretmaster, and Makyen) have even higher accesses to metasmoke systems, and Undo runs the system and has total control.
 </section>
 <section>
 
@@ -18,13 +18,13 @@ Just ask in [Charcoal HQ](https://chat.stackexchange.com/rooms/11540/charcoal-hq
 
 ### I have a feature request for one of the projects {#feature-request}
 
-First, put your idea out the folks in Charcoal HQ. If there seems to be a general consensus that it sounds like a good idea, make an issue on the appropriate GitHub repository. That way it's easier to track and discuss, and we won't forget about it.
+First, put your idea out to the folks in Charcoal HQ (CHQ). If there seems to be a general consensus that it sounds like a good idea, make an issue on the appropriate GitHub repository. That way it's easier to track and discuss, and we won't forget about it.
 </section>
 <section>
 
 ### I'd like to contact the SmokeDetector maintainers {#smokey-maintainers}
 
-Ping whichever of the following people happen to be in the room at the moment: Undo, ArtOfCode, angussidney, Thomas Ward, Andy, tripleee and iBug.
+Ping whichever of the following people happen to be in the room at the moment: Undo, ArtOfCode, angussidney, Thomas Ward, Andy, tripleee, iBug, and Makyen.
 </section>
 <section>
 
@@ -78,17 +78,17 @@ If you find a post that needs moderator attention in general, please just **flag
 
 ### It's dead Jim! {#dead}
 
-First of all, check that Smokey isn't responding to any commands. You can also try rebooting Smokey from either SOCVR or Tavern on the Meta, more often than not Smokey has just lost connection to CHQ. Next, check if the instance is still connected to MS [here](https://metasmoke.erwaysoftware.com/status) - if it is, something really bad has happened and you'll need to ask the person who owns the instance to shut it down. In the meantime, you can ask a code admin (`!!/whois code_admin`) to failover a new instance.
+First of all, check that Smokey isn't responding to any commands (e.g. `!!/location`, `!!/alive`, etc.). You can also try rebooting Smokey (i.e. `!!/reboot`) from Charcoal Test, SOCVR, or Tavern on the Meta. More often than not, Smokey has just lost connection to Charcoal HQ. Next, check if the instance is still connected to MS [here](https://metasmoke.erwaysoftware.com/status) - if it is, something really bad has happened and you'll need to ask the person who owns the instance to shut it down. In the meantime, you can ask a blacklister (`!!/whois blacklister`) to failover to a new instance.
 
-If all else fails, please ping one of the people with a **bold name** on [this list](/people), they will be able to start a backup instance of SmokeDetector.
+If all else fails, please ping one of the people with a **bold name** on [this list](/people), they will be able to start a backup instance of SmokeDetector, or reboot metasmoke.
 
 If even that fails, panicking is acceptable (but of course, you know where your towel is and will remain calm). Ping ArtOfCode or Undo - they have a few extra tools in metasmoke that may yet be able to resolve the issue.
 </section>
 <section>
 
 ### Someone is being disruptive in Charcoal HQ, who can sort the situation out? {#behavior}
 
-Ping one of the [Room Owners](https://chat.stackexchange.com/rooms/info/11540/charcoal-hq#room-ownercards), they will calm down the situation and take further action if necessary. If someone has violated SE's Be Nice policy, you can contact any diamond Moderator.
+Ping one of the [Room Owners](https://chat.stackexchange.com/rooms/info/11540/charcoal-hq#room-ownercards). They will calm down the situation and take further action if necessary. If someone has violated SE's Code of Conduct, you can contact any diamond Moderator using flags.
 </section>
 <section>
 
@@ -112,7 +112,7 @@ Ping Undo, ArtOfCode or angussidney, and they will give you push access to the r
 
 ### There's some other code that I'd like to contribute, who can I talk to to get it included? {#code}
 
-Just make a pull request to one of our repositories on GitHub, and one of the maintainers will review your code and merge it in. Note that some projects have Continuous Integration (CI) tests that needs to be passed before that can happen.
+Just make a pull request to one of our repositories on GitHub. One of the maintainers will review your code and merge it in. Note that some projects have Continuous Integration (CI) tests that needs to be passed before that can happen.
 </section>
 <section>
 

training/autoflagging.md

@@ -47,10 +47,12 @@ you want to, but they're not essential.
 
 [Next: Further Privileges: Core][6]
 
+[Return to Introduction Index][8]
 
 [meta]: https://meta.stackexchange.com/questions/291301
 [ms-su]: https://metasmoke.erwaysoftware.com/users/sign_up
 [ms-auth]: https://metasmoke.erwaysoftware.com/authentication/status
 [ms-wiz]: https://metasmoke.erwaysoftware.com/flagging/ocs
 [ms-fd]: https://metasmoke.erwaysoftware.com/flagging
 [6]: /training/core
+[8]: /training/index

training/code-admin.md → training/blacklister.md

@@ -1,26 +1,26 @@
 ---
 ---
 
-# 7. Further Privileges: Code Admin
+# 7. Further Privileges: Blacklister
 When you've been working within Charcoal for a while, there are further levels of privileges
-that you may be interested in getting. One of these is Code Admin, which deals with our
-blacklisting systems.
+that you may be interested in getting. One of these is blacklister (formerly known as "code admin"),
+which deals with our blacklisting systems.
 
-## What does code admin give you?
-Code admin gives you the ability to `!!/blacklist` and `!!/watch` independently - that is,
-without review from another code admin. If you don't know what that means, you're not ready
+## What does blacklister give you?
+Blacklister gives you the ability to `!!/blacklist` and `!!/watch` independently - that is,
+without review from another blacklister. If you don't know what that means, you're not ready
 for it yet.
 
 ## How do you get it?
-The grant for code admin is fully manual. If you've contributed a significant number of
-blacklist items and you seem to know what you're doing, you're likely to be given the code
-admin role. That's deliberately _not_ a hard criterion; it's subjective, because subjective
+The grant for blacklister is fully manual. If you've contributed a significant number of
+blacklist items and you seem to know what you're doing, you're likely to be given the blacklister
+role. That's deliberately _not_ a hard criterion; it's subjective, because subjective
 humans are the people granting it.
 
 ## How do you use it?
 Exactly the same as you've been using the `!!/blacklist` and `!!/watch` commands up to this
 point, except now your actions will take effect immediately without waiting for the pull
-request to be reviewed by another code admin.
+request to be reviewed by another blacklister.
 
 To reiterate our current blacklisting guidelines:
 
@@ -32,6 +32,15 @@ To reiterate our current blacklisting guidelines:
  - **Blacklisting keywords** is for phrases that get used in spam particularly frequently,
    and have no false positives.
 
-With all blacklists, remember to search on Stack Exchange as well as on metasmoke to check
-for false positives. Searching for spam amongst a dataset of spam is more than likely going
-to get some hits, but a Stack Exchange search reveals the real accuracy.
+With all blacklists, remember to [search on Stack Exchange][search-SE]
+as well as [on metasmoke][search-MS] to check
+for false positives. Searching for spam amongst a dataset of spam (i.e. on metasmoke) is more
+than likely going to get some hits, but a Stack Exchange search indicates probable false positives.
+
+-----
+
+[Return to Introduction Index][8]
+
+[search-SE]: https://stackexchange.com/search
+[search-MS]: https://m.erwaysoftware.com/search
+[8]: /training/index

training/charcoal.md

@@ -33,6 +33,8 @@ There are more people involved than that, of course - there's a
 
 [Next: What's spam?][2]
 
+[Return to Introduction Index][8]
+
 
 [people]: https://charcoal-se.org/people
 [sd]: https://github.com/Charcoal-SE/SmokeDetector
@@ -45,3 +47,4 @@ There are more people involved than that, of course - there's a
 [tripleee]: https://stackoverflow.com/u/874188
 [Makyen]: https://stackoverflow.com/users/3773011/makyen
 [2]: /training/spam
+[8]: /training/index

training/core.md

@@ -19,6 +19,9 @@ the Core role, it's rarely done, even if the person takes a hiatus from the proj
 
 -----
 
-[Next: Further Privileges: Code Admin][7]
+[Next: Further Privileges: Blacklister][7]
 
-[7]: /training/code-admin
+[Return to Introduction Index][8]
+
+[7]: /training/blacklister
+[8]: /training/index

training/index.md

@@ -27,7 +27,7 @@ This is a list of all the documents in this series. Start at the top and work yo
  - [Handling reports][4]
  - [Autoflagging][5]
  - [Further privileges: Core][6]
- - [Further privileges: Code Admin][7]
+ - [Further privileges: Blacklister][7]
 
 [hq]: https://chat.stackexchange.com/rooms/11540/charcoal-hq
 [1]: /training/charcoal
@@ -36,4 +36,4 @@ This is a list of all the documents in this series. Start at the top and work yo
 [4]: /training/reports
 [5]: /training/autoflagging
 [6]: /training/core
-[7]: /training/code-admin
+[7]: /training/blacklister

training/privileges.md

@@ -9,8 +9,9 @@ use privileged functionality.
 
 ## What do they let you do?
 They let you use privileged functionality. That includes running privileged
-commands. We have a full list available [in the wiki][commands]. You can also provide feedback 
-on SmokeDetector reports. More detail on [feedback][4] is provided in the next section. You can 
+commands and providing feedback on SmokeDetector reports.
+We have a full list of privileges available [in the wiki][commands]. More detail on [feedback][4]
+is provided in the next section. You can
 follow along with reports from SmokeDetector and flag spam without privileges, but if you want to 
 interact with SmokeDetector or the wider system, you'll need to be given privileges.
 
@@ -33,7 +34,7 @@ here it is in black and white:
  - **Report** posts that would be "red-flaggable" on the site. That is, if it could be
    spam- or abusive-flagged, you can report it to Smokey.
  - **Don't report**... well, anything else. In particular, don't report NAAs (posts that
-   are flaggable as Not An Answer), or self-vandalism.
+   are flaggable as Not An Answer), self-vandalism, or plagiarism.
 
 The general principle we work on is that we _want to_ catch anything that's red-flaggable,
 so if we've missed one, reporting it is good.
@@ -42,7 +43,9 @@ so if we've missed one, reporting it is good.
 
 [Next: Handling reports][4]
 
+[Return to Introduction Index][8]
 
 [commands]: https://charcoal-se.org/smokey/Commands#privileged-commands
 [wiki]: https://charcoal-se.org/smokey/Privileges
 [4]: /training/reports
+[8]: /training/index

training/reports.md

@@ -31,11 +31,27 @@ should exercise judgment while dealing with self-promotion.
 
  - Take a look at the user's profile. If this is their first post, they almost certainly
    just aren't aware of the policy about disclosure. You can let it go without flagging.
+ - On sites you're familiar with, many well-meaning users respond well a polite comment
+   requesting the author to edit in disclosure. If the post content is good it's definitely
+   preferred to have disclosure added by the author.
  - If you think it is worth a flag (perhaps because they've been doing this a lot),
    consider using a custom moderator attention flag rather than a spam flag. Those will
    take longer to be dealt with, but make it much easier for moderators to figure out _why_
    you flagged.
 
+## Comments on reported posts
+You should not leave comments under a post reported by SmokeDetector, unless you are otherwise
+familiar with that Stack Exchange site. In general, that means you participate on the site for
+more than responding to SmokeDetector reports and/or viewing a few Hot Network Questions.
+Unfortunately, we've had a case or two where comments left by people responding to a SmokeDetector
+report were taken negatively by the user and moderators of the site.
+
+When you're not otherwise familiar with the Stack Exchange site, instead of leaving a comment, you
+can raise a custom moderator flag explaining what the issue is.
+
+Note: This isn't a restriction on leaving comments *on metasmoke* on post reports, just on the
+actual posts on Stack Exchange sites.
+
 ## Userscripts
 While responding to SmokeDetector in chat is the original way of feeding back, over time
 we've streamlined the process. Most Charcoal members now use FIRE, a userscript that
@@ -46,7 +62,10 @@ You can find it, and all our other userscripts, on the [userscripts page][us].
 
 [Next: Autoflagging][5]
 
+[Return to Introduction Index][8]
+
 
 [wiki]: https://charcoal-se.org/smokey/Feedback-Guidance
 [us]: /scripts
 [5]: /training/autoflagging
+[8]: /training/index

training/spam.md

@@ -48,7 +48,10 @@ As always, use your best judgment, and ask if you're not sure.
 
 [Next: Privileges][3]
 
+[Return to Introduction Index][8]
+
 
 [def]: https://meta.stackexchange.com/q/58032
 [post]: https://metasmoke.erwaysoftware.com/post/108626
 [3]: /training/privileges
+[8]: /training/index