Merge pull request #4341 from JetBrains/move-kotlin-slack-guidelines

feat: move Kotlin Slack CC to docs

Author: zoobestik

docs/kr.tree

@@ -451,6 +451,7 @@
             <toc-element id="contribute.md"/>
             <toc-element id="kug-guidelines.md" accepts-web-file-names="kug-branding.html"/>
             <toc-element id="kotlin-night-guidelines.md" accepts-web-file-names="kotlin-nights-branding.html"/>
+            <toc-element id="slack-code-of-conduct.md"/>
         </toc-element>
         <toc-element id="kotlin-brand-assets.md" accepts-web-file-names="kotlin-logo.html"/>
         <toc-element toc-title="Press kit" href="https://kotlinlang.org/assets/kotlin-media-kit.pdf"/>

docs/topics/slack-code-of-conduct.md

@@ -0,0 +1,156 @@
+[//]: # (title: Code of conduct and guidelines for Kotlin Slack)
+
+Kotlin Slack aims to be an inclusive space committed to providing a friendly, safe and welcoming environment for all, 
+regardless of gender, sexual orientation, ability, ethnicity, socioeconomic status, and religion (or lack thereof).
+
+For this to be the case, it is vital that we all follow a basic set of guidelines and most importantly, 
+adhere to the code of conduct. 
+As such, please make sure you read this Code of Conduct and Basic Usage Guidelines in its entirety. 
+This isn't your regular License Agreement that you should scroll through and agree blindly.
+It's here for a reason and also contains practical information.
+
+* [How to behave](#how-to-behave)
+* [How not to behave](#how-not-to-behave)
+* [How to report issues](#how-to-report-issues)
+* [Moderators](#moderators)
+* [Basic usage guidelines](#basic-usage-guidelines)
+* [Moderators](#moderators)
+* [Copyright](#copyright)
+
+## How to behave
+
+* Participate in an authentic and active way. In doing so, you contribute to the health and longevity of this community.
+* Exercise consideration, respect and empathy in your speech and actions.
+  Remember, we have all been through different stages of learning when adopting technologies. 
+* Refrain from demeaning, discriminatory, or harassing behavior and speech.
+* Disagreements on things are fine, argumentative behavior or trolling are not. 
+
+## How not to behave
+
+* Do *not* perform threats of violence or use violent language directed against another person.
+* Do *not* make jokes of sexist, racist, homophobic, transphobic, ableist or otherwise discriminatory nature,
+  or use language of this nature.
+* Do *not* post or display sexually explicit or violent material.
+* Do *not* post or threaten to post other people's personally identifying information ("doxing").
+* Do *not* make personal insults, particularly those related to gender, sexual orientation, race, religion, or disability.
+* Do *not* engage in sexual attention. This includes, sexualized comments or jokes and sexual advances.
+* Do *not* advocate for, or encourage, any of the above behavior.
+
+## How to report issues
+
+If someone is acting inappropriately or violating this Code of Conduct in any shape or form,
+and they are not receptive to your feedback, or you prefer not to confront them, 
+please get in touch with one of the Administrators. 
+The main Administrators are Ilya Ryzhenkov (@orangy) and Hadi Hariri (@hhariri). 
+
+## Basic usage guidelines
+
+There are over 50 000 users on many different timezones using the Kotlin Slack, and the number is growing rapidly.
+The influx of messages per day and the numerous channels can lead to a lot of noise and little value in the long run.
+If we all follow a set of guidelines, it can help make things more useful and bearable for everyone. 
+
+* Please remember this is a Slack team for Kotlin. 
+  If you have generic questions that are about a technology (which may or may not be used with Kotlin),
+  maybe it's better to use another forum, such as StackOverflow. 
+* This Slack is not an official support channel. It is a place where the community hangs out along with some members 
+  of the JetBrains and Kotlin team (suffix [JetBrains]).
+* This Slack is not the best place for reporting bugs. For this, please use [YouTrack](https://youtrack.jetbrains.com/issues/kt).  
+* Find the right channel to ask your question. There are channels for pretty much every topic. 
+  [See the list of common channels](#common-channels).
+* New channels should be focused around a well-known technology or area of interest. Create them sparingly. 
+  And before requesting for a new channel, make sure it doesn't exist in any other shape or form. 
+  Ask an administrator to create a new channel on the #meta channel. 
+  If you do end up creating a channel, make sure you set the topic. 
+* Please refrain from cross-posting the same message on multiple channels. It is considered spamming.
+* When you ask a question, please be patient. Don't repeat it. Or at least not immediately.
+* Please do not ping or mention someone directly to get your questions answered, especially project owners, 
+  whether the project is Kotlin or other, unless they specifically indicate that you can. 
+* Don't split messages into multiple ones. Ask it all in a single message.
+* Use code blocks. Don't paste code as plain text. Slack supports Kotlin markup. 
+  If the code you are pasting is longer than a few lines, use "Code or text snippet" available from `+` menu next to message input.
+  Only first few lines will be displayed to all users and people interested in the code can expand your code to look into details.
+* While it's polite to say "Hi" or "I have a question" before asking something, it doesn't scale and leads to noise.
+  You can say hello in the same message you ask the question if you like.
+* Using threads is not required, but do take into account that it does allow people to more easily follow conversations, 
+  especially those jumping in late.
+* Use reactions to show gratitude as opposed to a message. It reduces the noise and gets the message across.
+* Don't use reactions to tell people they're in the wrong place or asking the wrong question. 
+  If they're on the wrong channel, point them to the right one. If their question is badly worded, help them correct it.
+  Have empathy. 
+* Take into account cultural differences. As they say, what the British say isn't what the British mean. 
+  Remember this both as the receiver and producer of messages.  
+* Don't create integrations with Slack. Given this is running on the free tier, 
+  the number is limited, and thus it won't be approved.
+* @channel, @here and other forms of notifications are disabled, even if you own a channel 
+  (unfortunately, Slack doesn't allow fine-grained permissions).
+* Use the #meta channel if you're unsure about how to do something.  
+
+## Moderators
+
+A moderator is a member of the Kotlin Slack community
+who volunteers to keep the kotlinlang Slack a safe and welcoming place for other members.
+Moderators are approved by kotlinlang Slack administrators.
+Their responsibilities and the guidelines they follow are described below.
+
+### Responsibilities
+
+* Monitor Slack channels to ensure compliance with the Code of Conduct.
+* Help community members follow the rules.
+* If a channel has additional rules, ensure these are visible and up to date.
+* Monitor the #reports and #meta channels.
+* Participate in the private #moderators channel.
+
+### Guidelines
+
+* Moderators communicate in a friendly manner and do their best to help other community members.
+* Any changes suggested by a moderator should be discussed by all moderators and administrators before coming into effect.
+
+### Process
+
+* Each moderator oversees at least one channel, or more if possible.
+* When moderators notice inappropriate behavior,
+  they explain the rules and guidelines to the members and help figure out how to correct the unwanted behavior.
+  If the unwanted behavior persists, moderators report the case to administrators for further actions.
+  In the case of obvious and/or particularly blatant violations, offending members can be reported immediately.
+* To set up or update a channel's rules, the moderator initiates a change proposal and discusses it with the appropriate community members.
+* Communication regarding moderation takes place in the private #moderators channel.
+* If community members notice that a moderator is ignoring their responsibilities (or engaging in any unwanted behavior),
+  they can alert administrators.
+
+### Moderator status acquisition and revocation process
+
+* Any member is welcome to apply to be a moderator once they have been in the Slack community for longer than 6 months.
+* Moderator status is provided based upon the decision of the administrators.
+* Moderator status can be revoked if (this list is not exhaustive and can be updated on a case-by-case basis):
+  * A moderator ignores their responsibilities, which leads to issues in a channel.
+  * A moderator violates these guidelines.   
+
+### The list of moderators {initial-collapse-state="collapsed"}
+
+At the moment we have 17 confirmed moderators, and they will be responsible for observing a total of 64 channels.
+For all other channels, if any issues arise, members can ping any of the moderators or admins directly,
+or they can post a message in #meta.
+
+* Alexander Nozik	(@altavir) – #mathematics, #science, #datascience, #education
+* Anderson Lameck	(@andylamax) – #coroutines, #kotlin-native, #webassembly, #serialization, #random, #javascript, #react
+* Andrey Mischenko	(@gildor) – #coroutines, #android, #gradle, #multiplatform, #getting-started, #kotlin-asia, #singapore
+* Eric Ampire	(@Eric Ampire) – #events
+* Holger Steinhauer	(@Holger Steinhauer) – #fosdem, #berlin, #vkug, #german-lang, #server
+* Louis CAD	(@louiscad) – #coroutines, #android
+* Magda Miu (@Magda Miu) – #android, #100daysofkotlin
+* Maryam Alhuthayfi (@Maryam Alhuthayfi) – #compose, #books, #ksp, #eap, #dagger, and #kontributors.
+* Nicola Corti	(@gammax) – #feed, #detekt, #appintro, #chucker, #fosdem, #london, #berlin, #hamburg, #sweden, #ktlint, 
+  #kug-leads, #kotlinconf, #koin, #koin-dev, #spek, #vkug
+* Paulien van Alst (@Paulien van Alst) – #detekt, #koin, #mockk
+* Qian Jin (@qian) – #kotlin-native, #android-studio, #french
+* Raul Raja	(@raulraja) - #arrow, #arrow-contributors, #arrow-meta
+* Sam Sam	(@sam) – #kotest, #kotest-contributors
+* Simon Vergauwen	(@simon.vergauwen) – #arrow, #arrow-contributors, #arrow-meta
+* Youssef Shoaib	(@Youssef Shoaib)  – #getting-started, #feed, #language-evolution, #language-proposals
+* Zach Klippenstein	(@Zach Klippenstein) – #coroutines, #compose, #compose-desktop, #compose-web, #squarelibraries, 
+  #library-development
+
+## Copyright
+
+This Code of Conduct is distributed under a [Creative Commons Attribution-ShareAlike license](http://creativecommons.org/licenses/by-sa/3.0/). 
+Portions of a text derived from the [Citizen Code of Conduct](http://citizencodeofconduct.org/).  

kotlin-website.py

@@ -344,9 +344,6 @@ def validate_links_weak(page, page_path):
         if href.scheme != '':
             continue
 
-        if page_path == 'community/slackccugl':
-            continue
-
         endpoint, params = url_adapter.match(href.path, 'GET', query_args={})
         if endpoint != 'page' and endpoint != 'get_index_page':
             response = app.test_client().get(href.path)