Skip to content

Commit 5ed4178

Browse files
jberkusstmcginnis
andauthored
Updated some slack rules to match actual practice. (#8203)
* Updated some slack rules to match actual practice. Signed-off-by: Josh Berkus <[email protected]> * Update communication/slack-guidelines.md Co-authored-by: Sean McGinnis <[email protected]> * A couple more spelling/grammar corrections. Signed-off-by: Josh Berkus <[email protected]> --------- Signed-off-by: Josh Berkus <[email protected]> Co-authored-by: Sean McGinnis <[email protected]>
1 parent 7320df8 commit 5ed4178

File tree

2 files changed

+76
-32
lines changed

2 files changed

+76
-32
lines changed

.github/ISSUE_TEMPLATE/slack-request.yml

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,8 +29,19 @@ body:
2929
label: Name of Requested Resource
3030
validations:
3131
required: false
32+
- type: input
33+
attributes:
34+
label: Is this request supported by an existing Kubernetes group (SIG, WG, Team, Subproject)? If so, please name them here, and tag a SIG lead who can verify
35+
the request.
36+
validations:
37+
required: false
3238
- type: textarea
3339
attributes:
3440
label: Description of Request
3541
validations:
36-
required: false
42+
required: false
43+
- type: textarea
44+
attributes:
45+
label: Justification for Request
46+
validations:
47+
required: false

communication/slack-guidelines.md

Lines changed: 64 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -40,24 +40,46 @@ administrators have time. There is no explicit interval.
4040

4141
[Slack Archive Download]
4242

43-
### DM (Direct Message) Conversations
44-
45-
Please do not engage in proprietary company specific conversations in the
46-
Kubernetes Slack instance. This workspace is meant for conversations related to
47-
Kubernetes open source topics and community. Proprietary conversations should
48-
occur in your company Slack and/or communication platforms. As with all
49-
communication, please be mindful of appropriateness, professionalism, and
50-
applicability to the Kubernetes community.
43+
### Slack Usage Rules
44+
45+
In addition to the [Code of Conduct][coc], users of Kubernetes Slack must adhere to
46+
the following behavior rules. Failure to follow them may result in warnings,
47+
removal of posts, escalating to temporary or permanent deactivation of the user
48+
account.
49+
50+
* **Adhere to Channel Topics**: for the most part, try to stick to the declared
51+
topic of the channel you're in.
52+
* **No Spam**: you may not post commercial, promotional messages anywhere in
53+
Kubernetes, whether in public channels or direct messages, except for very
54+
specific types of messages in specific channels were it is allowed.
55+
* **No Unsolicited DMs**: do not send any user uninvited direct messages (DMs).
56+
* **Don't Discuss Company Business**: Proprietary conversations should
57+
occur in your company Slack and/or communication platforms.
58+
* **No Surveys**: surveys, focus groups, free trials, and similar calls for
59+
participation are considered spam and are prohibited. Exceptions: an official
60+
Kubernetes community survey can be posted anywhere, and any survey may be
61+
posted to the Surveys channel.
62+
* **Jobs and Resumes** belong on the `#kubernetes-careers` channel and should not
63+
be posted elsewhere.
64+
* **Events** may only be posted to channels where that specific event is
65+
applicable, except for the `#events` channel. Generally, this only includes
66+
nonprofit community events.
5167

5268
### Specific Channel Rules
5369

5470
Some channels have specific rules or guidelines. If they do, they will be listed
55-
in the purpose or pinned docs of that channel.
56-
57-
- `#kubernetes-contributors` - Questions and discourse around upstream
58-
contributions and development to kubernetes.
71+
in the purpose or pinned docs of that channel. A few channels worth mentioning
72+
include:
73+
74+
- `#events` - announcements around any Kubernetes ecosystem related events.
75+
- `#kubernetes-new-contributors` - Questions and discourse around getting
76+
started contributing to Kubernetes.
77+
- `kubernetes-org-members` - Discussion by and for organization members and
78+
established contributors.
5979
- `#kubernetes-careers` - Job openings for positions working with/on/around
60-
Kubernetes. Postings must include:
80+
Kubernetes. These must be postings for specific jobs, not "cattle calls"
81+
for general tech hiring. You may also post resumes if you are looking
82+
to be hired. Job postings must include:
6183
- A link to the posting or job description.
6284
- The business name that will employ the Kubernetes hire.
6385
- The location of the role or if remote is OK.
@@ -89,7 +111,7 @@ issue can be documented, please take a screenshot to include in your message.
89111

90112
Send a DM to another [listed admin][admins] and describe the situation. If it's
91113
a [code of conduct][coc] issue, please send an email to <[email protected]>
92-
and describe the situation.
114+
and describe the situation.
93115

94116
## Should you have a channel on the Kubernetes Slack?
95117

@@ -99,9 +121,9 @@ strong ecosystem of channels for related things. Here are some guidelines for
99121
determining if you should request a channel:
100122

101123
- The channel MUST be Kubernetes related in some way.
102-
- Related cloud native projects might be more appropriate on the
124+
- Related cloud native projects might be more appropriate on the
103125
[CNCF Slack].
104-
- The project MUST be open source.
126+
- If requesting a project channel, the project MUST be open source.
105127
- Open Source a project BEFORE requesting a channel. We cannot accommodate
106128
every organization's open sourcing launch plans.
107129
- The purpose of Slack is to organize an existing community, not seed new
@@ -114,10 +136,10 @@ determining if you should request a channel:
114136
- Requesting a channel means maintaining it on behalf of the project
115137
filing the issue. You will be expected to participate and foster a
116138
healthy discourse.
117-
- External projects (ones not owned by a Kubernetes SIG) may have a
139+
- External projects (ones not owned by a Kubernetes SIG) may have a
118140
maximum of two channels, usually `#project` or `#project-users`,
119141
and `#project-dev`.
120-
- A second channel for a specific project will not be approved until the
142+
- A second channel for a specific project will not be approved until the
121143
first channel demonstrates significant traffic.
122144
- Channels around commercial services built on OSS projects are allowed.
123145
- Users love the value of being able to collaborate around various
@@ -128,10 +150,21 @@ determining if you should request a channel:
128150
heavily restrict private channels.
129151
- If you need private discussion areas for security-sensitive topics, a
130152
project-specific Slack or the [CNCF Slack] may be a better fit.
131-
- Ask in `#slack-admins` or file an issue if you're unsure It never hurts to
132-
ask.
153+
- Ask in `#slack-admins` or file an issue if you're unsure. We're happy to
154+
discuss it with you.
155+
156+
### Private Channels
157+
158+
We offer private channels on the Kubernetes Slack extremely sparingly. The only
159+
private channels we currently support involve community-owned software security
160+
or community moderation in some way. Unless supported by a Kubernetes SIG
161+
or the Steering Committee, requests for a private channel will be treated with
162+
skepticism.
163+
164+
Most private channels will be required to include a member of the Slack Admins
165+
team.
133166

134-
## Requesting a Channel
167+
### Requesting a Channel
135168

136169
Channels and User Groups are managed by [Tempelis], a tool that enables
137170
external management of Slack.
@@ -164,8 +197,8 @@ To add a channel, open a Pull Request (PR) updating the [slack-config].
164197
- Special accommodations will be made where necessary.
165198

166199
After you submit your request the Slack Admins will review and follow-up with
167-
any questions in the PR itself.
168-
There are two approvals needed. `/lgtm` and `/approve`. Once one moderator give the `/lgtm`, a hold will be placed on the PR using `/hold`. This hold will remain in place until one or more moderators reviews
200+
any questions in the PR itself.
201+
There are two approvals needed. `/lgtm` and `/approve`. Once one moderator give the `/lgtm`, a hold will be placed on the PR using `/hold`. This hold will remain in place until one or more moderators reviews
169202
and add the `/approve` command as well as `/hold cancel`, which will remove the hold on the PR.
170203
Once it is signed off and merged, the channel will be created.
171204

@@ -208,7 +241,7 @@ To delegate channel ownership - Open a Pull Request (PR) updating the
208241
After you submit your PR and the Slack Admins sign off on the update, it will be
209242
merged and the group will be able to fully self-manage their own channels.
210243
211-
For further information, see the
244+
For further information, see the
212245
[Slack Config Documentation][Channel Documentation].
213246
214247
## Requesting a User Group
@@ -219,7 +252,7 @@ external management of Slack.
219252
To add a User Group, open a Pull Request (PR) updating the [slack-config].
220253
221254
- Add the users to users.yaml. **NOTE:** This must be a mapping of their
222-
GitHub ID to their Slack Member ID.
255+
GitHub ID to their Slack Member ID.
223256
- To get a person's Slack Member ID, view their profile. Then click on the
224257
"**...**" and select **Copy member ID**. It will be a 9 character string of
225258
uppercase letters and numbers (example: `U1H63D8SZ`).
@@ -233,7 +266,7 @@ After you submit your request, the Slack Admins will review and follow-up with
233266
any questions in the PR itself. Once it is signed off by the members being added
234267
and the Slack Admins, it will be merged, and the User Group will be created.
235268

236-
For further information, see the
269+
For further information, see the
237270
[Slack Config Documentation][Channel Documentation].
238271

239272
## Requesting a Bot, Token, or Webhook
@@ -264,7 +297,7 @@ discussed in Slack itself.
264297

265298
### Admin Expectations and Guidelines
266299

267-
Admins should adhere to the general Kubernetes project
300+
Admins should adhere to the general Kubernetes project
268301
[moderation guidelines].
269302

270303
Additionally, admins should ensure they have 2-factor auth enabled for their
@@ -299,15 +332,15 @@ bots, tokens or webhooks. Please see the processes outlined below.
299332
#### Processing Channel Requests
300333

301334
Channel requests should be reviewed for their relation and relevance to the
302-
Kubernetes community. Typically channels should be dedicated to SIGs, WGs,
335+
Kubernetes community. Typically channels should be dedicated to SIGs, WGs,
303336
sub-projects, community topics, and other things related to Kubernetes programs
304337
and projects.
305338

306339
For Kubernetes project centric requests, validate them against the
307340
[sig-list], or request a link to a related issue/PR, or mailing
308341
list discussion for the requested Channel.
309342

310-
Small external projects are encouraged to use the channel of the SIG or WG
343+
Small external projects are encouraged to use the channel of the SIG or WG
311344
most relevant to them. Other things such as programming language-specific
312345
channels are discouraged and should in turn be steered to `#kubernetes-client`
313346
or communication avenues commonly used by their specific language.
@@ -360,7 +393,7 @@ steps.
360393
361394
For the reasons listed below, admins may inactivate individual Slack accounts.
362395
Due to Slack's framework, it does not allow for an account to be banned or
363-
suspended in the traditional sense, merely inactivated.
396+
suspended in the traditional sense, merely inactivated.
364397
See [Slack's policy on inactivated accounts] for more information.
365398
366399
#### Reasons to inactivate an account
@@ -385,7 +418,7 @@ This will open a contextually-aware prompt only available to Slack Admins with
385418
the options to deactivate the user and remove all content from them over the
386419
past "X" minutes/hours.
387420
388-
Report any actions taken to the other slack admins, and if needed the
421+
Report any actions taken to the other slack admins, and if needed the
389422
[Code of Conduct Committee][cocc].
390423
391424
[coc]: /code-of-conduct.md

0 commit comments

Comments
 (0)