Update communication guide to match style guidelines (#6491)

* Update communication guide to match style guidelines

Update the Zoom and Slack communication guides to match style guidelines. This also includes a few updates, grammar fixes, and modifications from the community.

Co-authored-by: Aaron Epperson <aaron@aaronepperson.com>
Co-authored-by: Bob Killen <killen.bob@gmail.com>

* Fix links in slack-guidelines

Co-authored-by: Aaron Epperson <aaron@aaronepperson.com>
Co-authored-by: Bob Killen <killen.bob@gmail.com>

1 files changed, 209 insertions, 232 deletions

diff --git a/communication/slack-guidelines.md b/communication/slack-guidelines.md
index 39b39a47..869dc2c4 100644
--- a/communication/slack-guidelines.md
+++ b/communication/slack-guidelines.md
@@ -1,61 +1,35 @@
 ---
 title: "Slack Guidelines"
 description: |
-  The policies, procedures, and escalation mechanisms for the Slack platform,
+  These are the policies, procedures, and escalation mechanisms for the Slack platform,
   such as requesting channels, tokens, and how to report inappropriate content.
 ---
 
-<!-- omit in toc -->
-# Slack Guidelines
-
 Slack serves as the main communication platform for the Kubernetes community
-outside of the mailing lists. It’s important that conversations stays on topic
-in each channel, and that everyone abides by the [Code of Conduct][coc]. There
-are over 100,000 members who should all expect to have a positive experience.
-
-Chat is searchable and public. Do not make comments that you would not say on a
-video recording or in another public space. Please be courteous to others.
-
-- [Code of Conduct](#code-of-conduct)
-- [Admins](#admins)
-- [General Communication Guidelines](#general-communication-guidelines)
-  - [Workspace Channel History](#workspace-channel-history)
-  - [DM (Direct Message) Conversations](#dm-direct-message-conversations)
-  - [Specific Channel Rules](#specific-channel-rules)
-  - [Escalating and/or Reporting a Problem](#escalating-andor-reporting-a-problem)
-- [Should you have a channel on the Kubernetes Slack?](#should-you-have-a-channel-on-the-kubernetes-slack)
-- [Requesting a Channel](#requesting-a-channel)
-  - [Delegating Channel Ownership](#delegating-channel-ownership)
-- [Requesting a User Group](#requesting-a-user-group)
-- [Requesting a Bot, Token, or Webhook](#requesting-a-bot-token-or-webhook)
-- [Moderation](#moderation)
-  - [Admin Expectations and Guidelines](#admin-expectations-and-guidelines)
-  - [Sending Messages to the Channel](#sending-messages-to-the-channel)
-  - [Processing Slack Requests](#processing-slack-requests)
-    - [Processing Channel Requests](#processing-channel-requests)
-    - [Processing User Group Requests](#processing-user-group-requests)
-    - [Processing Bot, Token, or Webhook Requests](#processing-bot-token-or-webhook-requests)
-  - [Inactivating Accounts](#inactivating-accounts)
+outside of the mailing lists. It's important that conversations stay on topic in
+each channel, and that everyone abides by the [Code of Conduct][coc]. There are
+over 150,000 members who should all expect to have a positive experience. You
+are a part of building and keeping a positive community.
 
+Chat is searchable and public. It's best not to make comments that you would not
+say on a video recording or in another public space. Please be courteous to
+others.
 
 ## Code of Conduct
 
 Kubernetes adheres to the [Kubernetes Code of Conduct][coc] throughout the
 project, and includes all communication mediums.
 
-
 ## Admins
 
-- Check the [centralized list of administrators][admins] for contact information.
+-   Check the [centralized list of administrators][admins] for contact information.
 
-Slack Admins will have listed that they are a Slack admin in their Slack profile,
-along with their specific timezone.
+Slack Admins will have listed that they are a Slack admin in their Slack
+profile, along with their specific timezone.
 
 To connect: please reach out in the `#slack-admins` channel, mention an admin
-directly in the `#slack-admins` channel when you have a question, or DM (Direct
-Message) one privately.
-
----
+directly in the `#slack-admins` channel when you have a question, or DM (direct
+message) one privately.
 
 ## General Communication Guidelines
 
@@ -64,36 +38,31 @@ Message) one privately.
 The Kubernetes Slack Workspace is archived and made available when the
 administrators have time. There is no explicit interval.
 
-[Slack Archive Download]
+[Slack Archive Download][]
 
 ### DM (Direct Message) Conversations
 
 Please do not engage in proprietary company specific conversations in the
 Kubernetes Slack instance. This workspace is meant for conversations related to
 Kubernetes open source topics and community. Proprietary conversations should
-occur in your company Slack and/or communication platforms.  As with all
+occur in your company Slack and/or communication platforms. As with all
 communication, please be mindful of appropriateness, professionalism, and
 applicability to the Kubernetes community.
 
-
 ### Specific Channel Rules
 
 Some channels have specific rules or guidelines. If they do, they will be listed
 in the purpose or pinned docs of that channel.
 
-- `#kubernetes-contributors` - Questions and discourse around upstream
-  contributions and development to kubernetes.
-- `#kubernetes-careers` - Job openings for positions working with/on/around
-  Kubernetes. This is the only channel where job postings are permitted. Postings
-  must include:
-  - A link to the posting or job description.
-  - The business name that will employ the Kubernetes hire.
-  - The location of the role or if remote is OK.
-- `#surveys` - third-party surveys, posted by vendors, recruiters, and researchers.
-  Ecosystem members may post relevant surveys here.  They may *not* post them in
-  any other channel; only surveys authored by official Kubernetes teams may be
-  shared in other channels.
-  
+-   `#kubernetes-contributors` - Questions and discourse around upstream
+    contributions and development to kubernetes.
+-   `#kubernetes-careers` - Job openings for positions working with/on/around
+    Kubernetes. Postings must include:
+    -   A link to the posting or job description.
+    -   The business name that will employ the Kubernetes hire.
+    -   The location of the role or if remote is OK.
+-   `#surveys` - Cloud native community wide surveys. Posts must be ecosystem
+    related.
 
 ### Escalating and/or Reporting a Problem
 
@@ -102,27 +71,25 @@ accessed by clicking on "More actions", the "**...**" to the right of a message,
 and selecting **Report message**.
 
 This will open a new dialog prompt where you may describe the problem. When
-done, it will send the reported message and your comments to **BOTH** the Slack
-admins and [Code of Conduct Committee (CoCC)][cocc].
+done, it will send the reported message and your comments to **BOTH** the
+[Slack admins][admins] and [Code of Conduct Committee (CoCC)][cocc].
 
 A Slack admin or CoCC member will work to resolve the issue or reach out for
 more information.
 
 If the issue has not been responded to in a timely manner, Join the
-`#slack-admins` channel and alert the admins to the current issue. Many Slack
+#slack-admins channel and alert the admins to the current issue. Many Slack
 admins watch the channel and should respond to you shortly.
 
 As a last resort, or if the issue is private, contact one of the admins in the
 [closest timezone][admins] via DM directly and describe the situation. If the
 issue can be documented, please take a screenshot to include in your message.
 
-**What if you have a problem with an admin?**
+#### What if you have a problem with an admin?
 
-Send a DM to another [listed admin][admins] and describe the situation. If it’s
+Send a DM to another [listed admin][admins] and describe the situation. If it's
 a [code of conduct][coc] issue, please send an email to <conduct@kubernetes.io>
-and describe the situation.
-
----
+and describe the situation. 
 
 ## Should you have a channel on the Kubernetes Slack?
 
@@ -131,189 +98,199 @@ Kubernetes project. However it is useful for developers and users to have a
 strong ecosystem of channels for related things. Here are some guidelines for
 determining if you should request a channel:
 
-- The channel MUST be Kubernetes related in some way.
-  - Related cloud native projects might be more appropriate on the [CNCF Slack].
-- The project MUST be open source. 
-  - If you are open sourcing a project DO THAT FIRST, we cannot accommodate every
-    organization's open sourcing launch plans.
-  - The purpose of Slack is to organize an existing community, not seed new ones.
-  - Moderators look at contributor activity, adoption and community consensus
-    around a project, otherwise Slack becomes a vehicle for promotion instead of
-    promulgation.
-  - Establishing and maintaining a Slack channel should be an inflection point
-    in a project's adoption.
-  - Requesting a channel means maintaining it on behalf of the project filing
-    the issue, you will be expected to participate and foster a healthy
-    discourse.
-- Channels around commercial services built on OSS projects are allowed.
-  - Users love the value of being able to collaborate around various services.
-  - Keep it classy, on the Kubernetes Slack we're all on the same team.
-- The channel MUST be public.
-  - In order to ensure all channels adhere to our Code of Conduct, we heavily
-    restrict private channels.
-  - We do allow `#...-dev` channels for established projects where a single
-    project channel is too noisy, but please don't create both at the start.
-  - If you need private discussion areas for security-sensitive topics, a
-    project-specific Slack or the [CNCF Slack] may be a better fit.
-- Ask in #slack-admins or file an issue if you're unsure, it never hurts to ask.
+-   The channel MUST be Kubernetes related in some way.
+    -   Related cloud native projects might be more appropriate on the 
+        [CNCF Slack][].
+-   The project MUST be open source.
+    -   Open Source a project BEFORE requesting a channel. We cannot accommodate
+        every organization's open sourcing launch plans.
+    -   The purpose of Slack is to organize an existing community, not seed new
+        ones.
+    -   Moderators look at contributor activity, adoption and community
+        consensus around a project, otherwise Slack becomes a vehicle for
+        promotion instead of promulgation.
+    -   Establishment and maintenance of a Slack channel should be an inflection
+        point in a project's adoption.
+    -   Requesting a channel means maintaining it on behalf of the project
+        filing the issue. You will be expected to participate and foster a
+        healthy discourse.
+-   Channels around commercial services built on OSS projects are allowed.
+    -   Users love the value of being able to collaborate around various
+        services.
+    -   Keep it classy, on the Kubernetes Slack we're all on the same team.
+-   The channel MUST be public.
+    -   In order to ensure all channels adhere to our Code of Conduct, we
+        heavily restrict private channels.
+    -   We do allow `#...-dev` channels for established projects where a single
+        project channel is too noisy, but please don't create both at the
+        start.
+    -   If you need private discussion areas for security-sensitive topics, a
+        project-specific Slack or the [CNCF Slack][] may be a better fit.
+-   Ask in `#slack-admins` or file an issue if you're unsure It never hurts to
+    ask.
 
 ## Requesting a Channel
 
-Channels and User Groups are managed by [Tempelis], a tool that enables external
-management of Slack.
-
-To add a channel, open a Pull Request (PR) updating the [slack-config].
-- Add the channel to [channels.yaml] following the [Channel Documentation].
-  - Channel names must be 21 characters or less in length (Slack limit).
-  - Typical channel naming conventions follow:
-    - `#kubernetes-foo`
-    - `#sig-foo`
-    - `#meetup-foo`
-    - `#location-user`
-    - `#projectname`
-- In the PR comments, include some details regarding the purpose of the Channel.
-  - Channels should be dedicated to [SIGs, WGs, UGs][sig-list], sub-projects,
-    community topics, or related Kubernetes programs/projects.
-  - Linking to resources such as the PR adding the subproject will speed in the
-    validation and processing of the channel creation request.
-  - Channels are **NOT**:
-    - Company specific; cloud providers are ok with product names as the channel.
-      Discourse will be about Kubernetes-related topics and not proprietary
-      information of the provider.
-    - Private channels with the exception of: code of conduct matters, mentoring,
-      security/vulnerabilities, github management, or steering committee.
-  - Special accommodations will be made where necessary.
+Channels and User Groups are managed by [Tempelis][], a tool that enables
+external management of Slack.
+
+To add a channel, open a Pull Request (PR) updating the [slack-config][].
+
+-   Add the channel to 'channels.yaml' following the [Channel Documentation][]
+    -   Channel names must be 21 characters or less in length, limited by Slack
+        design.
+    -   Channels must not share the same name with a Slack user or user group.
+    -   Typical channel naming conventions follow:
+        -   `#kubernetes-foo`
+        -   `#sig-foo`
+        -   `#meetup-foo`
+        -   `#location-user`
+        -   `#projectname`
+-   In the PR comments, include some details regarding the purpose of the
+    Channel.
+    -   Channels should be dedicated to [SIGs, WGs, UGs][sig-list], sub-projects,
+        community topics, or related Kubernetes programs/projects.
+    -   Linking to resources such as the PR adding the subproject will speed in
+        the validation and processing of the channel creation request.
+    -   Channels are NOT
+        -   **Company specific**; cloud providers are ok with product names as
+            the channel. Discourse will be about Kubernetes-related topics and
+            not proprietary information of the provider.
+        -   **Private channels** with the exception of: code of conduct matters,
+            mentoring, security/vulnerabilities, github management, or
+            steering committee.
+    -   Special accommodations will be made where necessary.
 
 After you submit your request the Slack Admins will review and follow-up with
-any questions in the PR itself. Once it is signed off and merged, the Channel
+any questions in the PR itself. Once it is signed off and merged, the channel
 will be created.
 
-For further information, see the [Slack Config Documentation].
-
+For further information, see the [Slack Config Documentation][].
 
 ### Delegating Channel Ownership
 
-Channel management can be delegated to other groups enabling SIG leads or other
-members to govern certain sets channels. This by-passes the need for a Slack
+Channel management can be delegated to other groups, enabling SIG leads or other
+members to govern certain sets of channels. This bypasses the need for a Slack
 Admins to sign-off on all requests and passes the responsibility to the most
 relevant group.
 
-To delegate channel ownership, open a Pull Request (PR) updating the
-[slack-config].
-- Create a sub-directory under the [slack-config] for your sig or group.
-- Update [restrictions.yaml] with an entry targeting yaml config files in the
-  sub-directory you created along with one or more regular expressions that
-  match the channel names that should be delegated.
-  - **Example Restrictions Entry:**
-    ```yaml
-    restrictions:
-    - path: "sig-foo/*.yaml"          # path to channel config
-      channels:
-      - "^kubernetes-foo-[a-z]{1,3}$" # channel regexp - example match: kubernetes-foo-bar
-      - "^foo-[a-zA-Z]+$"             # channel regexp - example match: foo-awesomechannel
-    ```
-- Create an [`OWNERS`] file in the sub-directory adding the appropriate
-  reviewers and approvers for the desired channels.
-- In the directory create one or more channel configs following the
-  [Channel Documentation].
-  - **Example Channel Config:**
-    ```yaml
-    channels:
-    - name: kubernetes-foo-bar # regexp: "^kubernetes-foo-[a-z]{1,3}$"
-    - name: foo-users          # regexp: "^foo-[a-zA-Z]+$"
-    - name: foo-dev            # regexp: "^foo-[a-zA-Z]+$"
-    ```
+To delegate channel ownership - Open a Pull Request (PR) updating the
+[slack-config][].
+
+-   Create a sub-directory under the [slack-config][] for your sig or group.
+-   Update restrictions.yaml with an entry targeting yaml config files in the
+    sub-directory you created along with one or more regular expressions that
+    match the channel names that should be delegated.
+    -   **Example Restrictions Entry:**
+        ```yaml
+        restrictions:
+        - path: "sig-foo/*.yaml"          # path to channel config
+          channels:
+          - "^kubernetes-foo-[a-z]{1,3}$" # channel regexp - example match: kubernetes-foo-bar
+          - "^foo-[a-zA-Z]+$"             # channel regexp - example match: foo-awesomechannel
+        ```
+-   Create an [OWNERS][] file in the sub-directory adding the appropriate
+    reviewers and approvers for the desired channels.
+-   In the directory create one or more channel configs following the Channel
+    Documentation
+    -   **Example Channel Config:**
+        ```yaml
+        channels:
+        - name: kubernetes-foo-bar # regexp: "^kubernetes-foo-[a-z]{1,3}$"
+        - name: foo-users          # regexp: "^foo-[a-zA-Z]+$"
+        - name: foo-dev            # regexp: "^foo-[a-zA-Z]+$"
+        ```
+
 After you submit your PR and the Slack Admins sign off on the update, it will be
 merged and the group will be able to fully self-manage their own channels.
 
-For further information, see the [Slack Config Documentation].
+For further information, see the 
+[Slack Config Documentation][Channel Documentation].
 
 ## Requesting a User Group
 
-Channels and User Groups are managed by [Tempelis], a tool that enables external
-management of Slack.
+Channels and User Groups are managed by [Tempelis][], a tool that enables
+external management of Slack.
 
-To add a User Group, open a Pull Request (PR) updating the [slack-config].
-- Add the [users] to [users.yaml]. **NOTE:** This **must** be a mapping of their
-  GitHub ID to their Slack Member ID.
-  - To get a person's Slack Member ID, view their profile. Then click on the
-    "**...**" and select **Copy member ID**. It will be a  9 character string of
+To add a User Group, open a Pull Request (PR) updating the [slack-config][].
+
+-   Add the users to users.yaml. **NOTE:** This must be a mapping of their
+    GitHub ID to their Slack Member ID. 
+-   To get a person's Slack Member ID, view their profile. Then click on the
+    "**...**" and select **Copy member ID**. It will be a 9 character string of
     uppercase letters and numbers (example: `U1H63D8SZ`).
-- Update [usergroups.yaml] Follow the guidelines for creating a User Group in
-  the Slack Config [User Group Documentation].
-- In the PR comments, include details on the User Group and `/cc` the members
-  you are adding so that they may sign off and accept being added to the group.
+-   Update [usergroups.yaml][] Follow the guidelines for creating a User Group
+    in the Slack Config [User Group Documentation][].
+-   In the PR comments, include details on the User Group and `/cc` the members
+    you are adding so that they may sign off and accept being added to the
+    group.
 
 After you submit your request, the Slack Admins will review and follow-up with
 any questions in the PR itself. Once it is signed off by the members being added
 and the Slack Admins, it will be merged, and the User Group will be created.
 
-For further information, see the [Slack Config Documentation].
-
+For further information, see the 
+[Slack Config Documentation][Channel Documentation].
 
 ## Requesting a Bot, Token, or Webhook
 
 **READ BEFORE SUBMITTING A REQUEST**
 
-Bots, tokens, and webhooks are reviewed on a case-by-case basis with most
-requests being rejected due to security, privacy, and usability concerns. Bots
+Bots, tokens, and webhooks are reviewed on a case-by-case basis **with most
+requests being rejected due to security, privacy, and usability concerns**. Bots
 and the like tend to make a lot of noise in channels. The Kubernetes Slack
-instance has over 50,000 members and it is the role of the Slack admins to
+instance has over 145,000 members and it is the role of the Slack admins to
 ensure everyone has a great experience.
 
 Typically approved requests include: GitHub, CNCF requests, or other
 tools/platforms used to aid in the management of Slack itself.
 
-- Create a [GitHub Issue] using the Slack Request template.
-- In the description, describe the request, its intended purpose and benefit to
-  the community. Supplying links to supporting content such as a document
-  outlining what OAuth scopes that are requested, and why are
-  **STRONGLY ENCOURAGED**.
+-   Create a [GitHub Issue][] using the Slack Request template.
+-   In the description, describe the request, its intended purpose and benefit
+    to the community. Supplying links to supporting content such as a document
+    outlining what OAuth scopes that are requested and why are **STRONGLY
+    ENCOURAGED**.
 
-After you submit your request the Slack admins will review and follow-up with
+After you submit your request, the Slack admins will review and follow-up with
 any questions in the issue. If consensus can be reached among the admins, the
 request will be approved and follow-up communication on implementation will be
 discussed in Slack itself.
 
----
-
 ## Moderation
 
 ### Admin Expectations and Guidelines
 
-Admins should adhere to the general Kubernetes project [moderation guidelines].
+Admins should adhere to the general Kubernetes project 
+[moderation guidelines][].
 
 Additionally, admins should ensure they have 2-factor auth enabled for their
 account and mention they are a Slack admin in the "What I do" portion of their
-profile. This message should also include the timezone they are representing.
+profile. This message should also include the time zone they are representing.
 
 Be mindful of how you handle communication during stressful interactions.
 Administrators act as direct representatives of the community, and need to
 maintain a very high level of professionalism at all times. If you feel too
-involved in the situation to maintain impartiality or professionalism, that’s
-a great time to enlist the help of another admin.
+involved in the situation to maintain impartiality or professionalism, that's a
+great time to enlist the help of another admin.
 
 Try to take any situations that involve upset or angry members to DM or video
 chat. Please document these interactions for other Slack admins to review.
 
 Content will be removed if it violates code of conduct or is a sales pitch.
 Admins will take a screenshot of such behavior in order to document the
-situation. The community takes such violations extremely seriously, and the
+situation. **The community takes such violations extremely seriously**, and the
 admins are empowered to handle it swiftly.
 
-
 ### Sending Messages to the Channel
 
 `@all`, `@here` and `@channel` should be used rarely. Members will receive
-notifications from these commands. Remember Kubernetes is a global project -
-please be kind.
-
+notifications from these commands. Remember Kubernetes is a global
+project---please be kind.
 
 ### Processing Slack Requests
 
 Admins are tasked with processing requests for channels and other things such as
-bots, tokens or webhook.
-
+bots, tokens or webhooks. Please see the processes outlined below.
 
 #### Processing Channel Requests
 
@@ -322,12 +299,12 @@ Kubernetes community. Typically channels should be dedicated to SIGs, WGs, UGs,
 sub-projects, community topics, and other things related to Kubernetes programs
 and projects.
 
-For Kubernetes project centric requests, validate them against the [sig-list],
-or request a link to a related issue/PR, or mailing list discussion for the
-requested Channel.
+For Kubernetes project centric requests, validate them against the
+[sig-list], or request a link to a related issue/PR, or mailing
+list discussion for the requested Channel.
 
 Small external projects are encouraged to use the channel of the SIG, WG, or UG
-most relevant to them. Other things such as programming language specific
+most relevant to them. Other things such as programming language-specific
 channels are discouraged and should in turn be steered to `#kubernetes-client`
 or communication avenues commonly used by their specific language.
 
@@ -336,12 +313,15 @@ In general, use your best judgment.
 Once two Slack admins have reviewed and agreed to sponsor the channel, they will
 sign off on the Channel Request PR. Once merged, the channel will be created.
 
-Channels managed by [Tempelis] will automatically have [default messages pinned].
-For any manually provisioned channels, such as private channels, add the below
-message and pin it.
+Channels managed by [Tempelis][] will automatically have default messages
+pinned. For any manually-provisioned channels, such as private channels, add the
+below message and pin it.
+
 ```
-This channel abides to the Kubernetes Code of Conduct - http://git.k8s.io/community/code-of-conduct.md
-Contact conduct@kubernetes.io or an admin in the #slack-admins channel if there is a problem.
+This channel abides to the Kubernetes Code of Conduct -
+http://git.k8s.io/community/code-of-conduct.md
+Contact conduct@kubernetes.io or an admin in the #slack-admins channel if there
+is a problem.
 ```
 
 #### Processing User Group Requests
@@ -353,73 +333,70 @@ are a useful alias, but can also easily be spammed or abused.
 Before signing off on a User Group PR request, ensure all members of the User
 Group have signed off acknowledging they will be added to the group.
 
-After all the User Group members have accepted being added to the group, and two
+After all the User Group members have accepted being added to the group and two
 Slack Admins have signed off on the request, the PR will be merged. Once merged,
 the User Group will be created.
 
-
 #### Processing Bot, Token, or Webhook Requests
 
 Requests should first be evaluated for their relevance to the project. Typically
-approved requests are related to: GitHub, the CNCF, or other tools/platforms
+approved requests are related to: GitHub, the CNCF, or other tools and platforms
 used to aid in the management of Slack. Requests outside of this scope should be
 heavily scrutinized and reviewed for **ANY** potential security, privacy, or
 usability concerns.
 
-It is best to err on the side of not allowing a Bot, Token or Webhook request
-than allowing one.
-
-If consensus among the admins can be reached regarding the request; an admin
-should assign the issue to themselves, and reach out to the request contact
-regarding next steps.
+It is best to err on the side of not allowing a bot, token, or webhook request
+rather than allowing one.
 
+If the admins come to consensus and agree to the request, an admin should assign
+the issue to themselves and reach out to the request contact regarding next
+steps.
 
 ### Inactivating Accounts
 
 For the reasons listed below, admins may inactivate individual Slack accounts.
-Due to Slack’s framework, it does not allow for an account to be banned or
-suspended in the traditional sense, merely inactivated. See [Slack’s policy on
-inactivated accounts] for more information.
+Due to Slack's framework, it does not allow for an account to be banned or
+suspended in the traditional sense, merely inactivated. 
+See [Slack's policy on inactivated accounts][] for more information.
 
-- Spreading spam content in DMs and/or channels.
-- Not adhering to the code of conduct set forth in DMs and/or channels.
-- Overtly selling products, related or unrelated to Kubernetes.
+#### Reasons to inactivate an account
+
+-   Spreading spam content in DMs and/or channels.
+-   Not adhering to the code of conduct set forth in DMs and/or channels.
+-   Overtly selling products, related or unrelated to Kubernetes.
 
 **BE CAREFUL**
 
-To inactivate a user, and optionally remove their content (spam). First, double
-check you have the correct user by verifying their Slack Member ID. Spammers may
-try and fake or assume the identity of another user.
+To inactivate a user, and optionally remove their content (spam):
+
+-   First, double check you have the correct user by verifying their Slack
+    Member ID.
+-   Spammers may try and fake or assume the identity of another user.
 
-Once verified, find a message from the offending user. Then select
-"**More actions**", the "**...**" to the right of a message from the offending user.
-Then select "**Report message**".
+Once verified, find a message from the offending user. Then select **More
+actions**, the "**...**" to the right of a message from the offending user. Then
+select **Report message**.
 
-This will open a contextually aware prompt only available to Slack Admins with
-the options to deactivate the user and remove all content from them over the 
+This will open a contextually-aware prompt only available to Slack Admins with
+the options to deactivate the user and remove all content from them over the
 past "X" minutes/hours.
 
-Report any actions taken to the other slack admins, and if needed the
+Report any actions taken to the other slack admins, and if needed the 
 [Code of Conduct Committee][cocc].
 
-[coc]: /code-of-conduct.md
-[admins]: ./moderators.md#Slack
-[Slack Archive Download]: https://drive.google.com/drive/folders/1Xnkwsxis3tu0pT7rwp-crRq4IciZ5b1o?usp=sharing
-[cocc]: /committee-code-of-conduct/README.md
-[GitHub Issue]: https://github.com/kubernetes/community/issues/new/choose
-[sig-list]: /sig-list.md
-[tempelis]: http://sigs.k8s.io/slack-infra/tempelis
-[slack-config]: ./slack-config/
-[Channel Documentation]: ./slack-config/README.md#channels
-[channels.yaml]: ./slack-config/channels.yaml
-[restrictions.yaml]: ./slack-config/restrictions.yaml
-[`owners`]: /contributors/guide/owners.md
-[users]: ./slack-config/README.md#users
-[users.yaml]: ./slack-config/users.yaml
-[usergroups.yaml]: ./slack-config/usergroups.yaml
-[User Group Documentation]: ./slack-config/README.md#usergroups
-[Slack Config Documentation]: ./slack-config/README.md
-[default message pinned]: ./slack-config/template.yaml
-[Slack’s policy on inactivated accounts]: https://get.Slack.help/hc/en-us/articles/204475027-Deactivate-a-member-s-account
-[moderation guidelines]: ./moderation.md
-[CNCF Slack]: https://slack.cncf.io/
+  [coc]: /code-of-conduct.md
+  [admins]: ./moderators.md#Slack
+  [Slack Archive Download]: https://drive.google.com/drive/folders/1Xnkwsxis3tu0pT7rwp-crRq4IciZ5b1o?usp=sharing
+  [cocc]: /committee-code-of-conduct/README.md
+  [CNCF Slack]: https://slack.cncf.io/
+  [Tempelis]: http://sigs.k8s.io/slack-infra/tempelis
+  [slack-config]: ./slack-config/
+  [Channel Documentation]: ./slack-config/README.md
+  [sig-list]: https://www.kubernetes.dev/community/community-groups
+  [Slack Config Documentation]: ./slack-config/README.md
+  [OWNERS]: /contributors/guide/owners
+  [usergroups.yaml]: ./slack-config/usergroups.yaml
+  [User Group Documentation]: ./slack-config/README.md#usergroups
+  [GitHub Issue]: https://github.com/kubernetes/community/issues/new/choose
+  [moderation guidelines]: ./moderation.md
+  [Slack's policy on inactivated accounts]: https://get.slack.help/hc/en-us/articles/204475027-Deactivate-a-member-s-account