Home Slack for ASF projects (edit)

Slack for ASF projects

The Apache Software Foundation has a workspace on Slack to provide channels on which people working on the same ASF project, or in the same area of the Foundation, can discuss issues, solve problems, and build community in real-time.

A thread in a Slack channel can be a great place to work through a knotty question and move toward consensus. However, coming to agreement about something on Slack does not mean the PMC has agreed to or approved something. All formal PMC decisions should take place in one of the project's email lists, so we all have an audit trail of who decided what, and when.

Joining the ASF Slack workspace

Anyone with an @apache.org email address can become a full member of the ASF Slack workspace. Use the link above to log in to the-asf.slack.com. You can then browse for the open channels you want to join.

You can also download an app to use on your computer or mobile device.

If you want to invite ASF members who are not on Slack yet to join your project's Slack discussions:

  1. In the Slack app, click the "ASF" header at the top left.
  2. Select Invite people to ASF
  3. Use the Members option and, in the form that appears, provide the person's ASF email address.

Other contributors and interested parties (observers, former members, software evaluators, members of the media, those without an @apache.org address) who want to participate in channels in the ASF workspace can use a guest account. There are two ways to do this:

  1. Someone already part of the workspace invites you to join a particular channel
    • In the Slack app, click the "ASF" header at the top left.
    • Select Invite people to ASF.
    • Use theSingle channel guests option and, in the form that appears, provide the email addresses of the people you would like to invite to a specific channel.
  2. Share this URL with a person who wants to take part in the Slack discussions: https://s.apache.org/slack-invite. The person who joins in this way becomes a member with access to all public channels in the workspace. Note: When Slack does an update, this URL occasionally stops functioning as it should. If the potential participant uses it and the submission form asks for an Apache email address, let Infra know so we can update the URL.

Slack Account Types

Slack has three account types:

  • Member: has full access to all Slack's features, including inviting others to join the workspace.
  • Multi-Channel Guest: has limited access inside Slack, but can join as many open channels as they wish.
  • Single-Channel Guest: can only access the channel they are invited to join.

Slack has a list of permissions for these account types.

ASF and Slack 'members'

Both the ASF and Slack use the term 'member', but in different ways. The Slack use of "member" is above.

For the Apache Software Foundation:

  • An ASF Member is a "person who was nominated by current members and elected due to merit for the evolution and progress of the foundation."
  • A PMC member is a "developer or a committer that was elected" to the PMC.

Joining project channels

Once you are part of the ASF workspace as a member or a multi-channel guest, you can join any open channels you wish to.

  • At the top of your list of channels in the Slack app, click the + icon.
  • Use the Browse channels option to display a list of open channels in the workspace; or enter text in the search field.
  • Select any channel to add it to your channel list.

Some ASF channels are private or locked, and do not appear on the list of channels you can join. Someone who is already in the channel has to invite you to join such a channel.

If you are a single-channel guest, you cannot join other channels.

It is good manners to send a hello message to a channel you join, possibly with a short statement of why you are there.

Setting up a project channel

Before setting up a new project channel, search the ASF workspace to make sure it does not already exist. If it does not, any member of the workspace can add the channel.

  • At the top of your list of channels in the Slack app, click the + icon
  • Use the Browse channels option to see if the channel you are thinking of already exists. If you can't find it, click Create Channel at the top of the channels list; or use the Create a channel option under the + icon.

If you do add a channel for your project, make sure you tell the PMC, committers, and other stakeholders about it so they can find and make use of it.

Expectations

As with all ASF activities, we expect ASF Members and project participants to conduct themselves according to the ASF Code of Conduct.

We expect channel participants to be respectful and supportive of other participants, and to make contributions that add to the conversation, rather than blurring it. If a participant makes contributions that are disrespectful, offensive, or contrary in other ways to The Apache Way, please report them to Infra.

Copyright 2020, The Apache Software Foundation, Licensed under the Apache License, Version 2.0.
Apache® and the Apache feather logo are trademarks of The Apache Software Foundation...