community/communication/slack-config
Roman Mohr 6e995e7252 Add kubevirt-dev slack channel
Most communication regarding to the CNCF sandbox project KubeVirt is
happening inside #virtualization. We are spending a lot of time also on
development and keeping our e2e tests stable. This creates a lot of
traffic which we don't think is good to have in #virtualization. We
therefore want to have a dedicated channel to discuss and reports issues
around code and CI.

Signed-off-by: Roman Mohr <rmohr@redhat.com>
2020-07-03 12:39:58 +02:00
..
sig-architecture slack-config/sig-arch: Add enhancements-owners usergroup 2020-04-16 18:14:10 -04:00
sig-cloud-provider slack: renamed provider-alibaba-cloud channel 2019-12-20 18:31:04 +09:00
sig-docs Add Slack channel for Ukrainian localization 2020-01-10 14:25:35 +02:00
sig-network Add sig-network-service-apis slack channel. (#4281) 2019-12-06 10:30:50 -08:00
sig-release slack/sig-release: Add release-team-leads usergroup 2020-06-11 02:29:58 -04:00
sig-storage Add slack channel for csi-windows working group 2019-09-06 10:22:06 -07:00
OWNERS Add slack label to slack-config 2019-04-14 14:40:11 -07:00
README.md fix Tempelis readme link 2019-04-12 15:36:02 -07:00
channels.yaml Add kubevirt-dev slack channel 2020-07-03 12:39:58 +02:00
restrictions.yaml slack-config/sig-arch: Add enhancements-owners usergroup 2020-04-16 18:14:10 -04:00
template.yaml Add initial slack config 2019-04-11 16:14:45 -07:00
usergroups.yaml Add a slack group for Velero maintainers (#4783) 2020-05-18 05:07:36 -07:00
users.yaml slack/sig-release: Update release-managers usergroup 2020-06-11 02:29:58 -04:00

README.md

Slack Config

YAML files in this directory control the state of Slack, via Tempelis. Updating a configuration file will result in Slack being updated once the change merges. If a change is not legal, a presubmit will fail.

Users

There is no safe, stable way to derive a specific Slack user from any human-readable identifier. Instead of using Slack IDs everywhere, a single mapping from GitHub usernames to Slack IDs is given in users.yaml. To reference a user, they must first be added to users.yaml.

Channels

Channels can be created by adding a new channel in channels.yaml. Channels should be sorted alphabetically. New channels will be created in accordance with the template specified in template.yaml.

Deleting channels is not permitted, but a channel can be archived by specifying archived: true, or unarchived by removing it (or specifying false).

To rename a channel, set its id property to its current Slack ID, then change the name.

A fully-specified channel looks like this:

- name: slack-admins # mandatory
  id: C4M06S5HS      # optional except when renaming
  archived: false    # optional for unarchived channels

Usergroups

Usergroups are pingable Slack groups. All members of a usergroup can be automatically added to certain channels. A usergroup must have at least one member. A usergroup can be removed by deleting it from the configuration.

Some usergroups (e.g. @test-infra-oncall) are managed by other tooling. To prevent Tempelis from trying to deactivate these usergroups, they can be included on the list and marked as external: true. Other usergroups should look like this:

- name: slack-admins               # mandatory, the pingable handle
  long_name: Slack Admins          # mandatory, the human-readable name
  description: Slack Admin Group   # mandatory, a description
  channels:                        # optional, a list of channels for members to auto-join
    - slack-admins
  members:                         # mandatory, a list of at least one member.
    - castrojo                     # member names must be listed in users.yaml.
    - katharine
    - jeefy
    - mrbobbytables
    - alejandrox1
    - jdumars
    - parispitmann
    - coderanger
    - idvoretskyi
    - idealhack