Code of Conduct and Guidelines for Kotlin Slack
- How to behave
- How not to behave
- How to report issues
- Basic Usage Guidelines
- Common Channels
Kotlin Slack aims to be an inclusive space that is 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 blindy. It’s here for a reason and also contains practical information.
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 behaviour 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 39000 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 hang out along with some members of the JetBrains/Kotlin team (suffix [JB]). For official support, please use the Kotlin Forums, where messages are also persisted.
- This Slack is not the best place for reporting bugs either. For this, please use YouTrack.
- Find the right channel to ask your question. There are channels for pretty much every topic. For a list of some of the channels see below.
- New channels should be focused around a well-known technology or area of interest. Create them sparingly. And before creating a new channel, make sure it doesn’t exist in any other shape or form. If you do end up creating a channel, make sure you set the topic.
- 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, specially 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.
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.
- 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.
- 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.
- Each moderator oversees at least 1 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 places 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/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.
This is a list of some of the most popular channels, as well as a sample of the types of channels available.
- #android. Using Kotlin for Android development (consider to use StackOverflow or other communities for generic Android question not directly related to Kotlin, even if you use Kotlin for Android development).
- #getting-started. For more beginner questions. Better ask here than in #general if you’re new to Kotlin
- #communities. A place to discuss physical communities. Also search for cities/countries as there are often channels with these names (#australia), as well as languages (i.e. #spanish).
- #coroutines. Questions about coroutines and async programming in Kotlin
- #dagger. About the Dagger framework.
- #datascience. Using Kotlin for Data Science.
- #functional. Functional programming topics with Kotlin
- #gradle. Working with Gradle and Kotlin Script Gradle
- #intellij. Question regarding the Kotlin plugin for IntelliJ IDEA
- #javafx. Working with JavaFX
- #koans. Have questions about the Kotlin Koans?
- #kobalt. Working with Kobalt builds
- #kontributors. Contributing to Kotlin
- #language-proposals. Discussions around new language proposals
- #native. For questions about Kotlin/Native
- #random. For random things.
- #reflect. For topics around reflection.
- #scripting. For Kotlin Scripting
- #server. For server-side Kotlin
- #speaking. Want to speak or find a speaker?
- #spring. Questions about the Spring framework
- #vertx. Working with Vert.x