CINXE.COM
Slack for ASF projects - Apache Infrastructure Website
<!doctype html> <html class="no-js" lang="en" dir="ltr"> <head> <meta charset="utf-8"> <meta http-equiv="x-ua-compatible" content="ie=edge"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Slack for ASF projects - Apache Infrastructure Website</title> <link href="/css/bootstrap.min.css" rel="stylesheet"> <link href="/css/fontawesome.all.min.css" rel="stylesheet"> <link href="/css/headerlink.css" rel="stylesheet"> <script src="/highlight/highlight.min.js"></script> </head> <body class="d-flex flex-column h-100"> <main class="flex-shrink-0"> <div> <!-- nav bar --> <nav class="navbar navbar-expand-lg navbar-dark bg-dark" aria-label="Fifth navbar example"> <div class="container-fluid"> <a class="navbar-brand" href="/"><img src="/images/feather.png" style="height: 32px;"/> Apache Infrastructure</a> <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarADP" aria-controls="navbarADP" aria-expanded="false" aria-label="Toggle navigation"> <span class="navbar-toggler-icon"></span> </button> <div class="collapse navbar-collapse" id="navbarADP"> <ul class="navbar-nav me-auto mb-2 mb-lg-0"> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" data-bs-toggle="dropdown" aria-expanded="false">About</a> <ul class="dropdown-menu"> <li><a class="dropdown-item" href="/infra-news.html">News</a></li> <li><a class="dropdown-item" href="/blog/">The Infrastructure Blog</a></li> <li><a class="dropdown-item" href="/roundtable.html">The Infrastructure Roundtable</a></li> <li><a class="dropdown-item" href="/team.html">About the team</a></li> </ul> </li> <li class="nav-item"> <a class="nav-link" href="/policies.html">Policies</a> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" data-bs-toggle="dropdown" aria-expanded="false">Services and Tools</a> <ul class="dropdown-menu"> <li><a class="dropdown-item" href="/services.html">Services and Tools</a></li> <li><a class="dropdown-item" href="https://blocky.apache.org/">Blocky</a></li> <li><a class="dropdown-item" href="https://app.datadoghq.com/account/login?next=%2Finfrastructure">DataDog</a></li> <li><a class="dropdown-item" href="https://whimsy.apache.org/roster/committer/" target="_blank">Committer Search</a></li> </ul> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" data-bs-toggle="dropdown" aria-expanded="false">Documentation</a> <ul class="dropdown-menu"> <li><a class="dropdown-item" href="/doc.html">Contribute</a></li> <li><a class="dropdown-item" href="/infra-volunteer.html">Volunteer with Infra</a></li> <li><a class="dropdown-item" href="/how-to-mirror.html">Become an ASF download mirror</a></li> <li><a class="dropdown-item" href="/hosting-external-agent.html">Host a Jenkins or Buildbot agent</a></li> </ul> </li> <li class="nav-item"> <a class="nav-link" href="/stats.html">Status</a> </li> <li class="nav-item"> <a class="nav-link" href="/contact.html">Contact Us</a> </li> </ul> </div> </div> </nav> <!-- page contents --> <div id="contents"> <div class="bg-white p-5 rounded"> <div class="col-sm-8 mx-auto"> <h1> Slack for ASF projects </h1> <p>The Apache Software Foundation has a workspace on <a href="https://the-asf.slack.com/" target="_blank">Slack</a> 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.</p> <p>A thread in a Slack channel can be a great place to work through a knotty question and move toward consensus. <strong>However</strong>, 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.</p> <h2>Joining the ASF Slack workspace</h2> <p>Anyone with an <code>@apache.org</code> email address can become a full member of the ASF Slack workspace. Use that email address and the link above to log in to <code>the-asf.slack.com</code>. You can then browse for the open channels you want to join.</p> <p>You can also download an app to use on your computer or mobile device.</p> <p>If you want to invite ASF people (those with an @apache.org address) who are not on Slack yet to join your project's Slack discussions:</p> <ol> <li>In the Slack app, click the "ASF" header at the top left.</li> <li>Select <code>Invite people to ASF</code></li> <li>Use the <code>Members</code> option and, in the form that appears, provide the person's ASF email address.</li> </ol> <p>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 <strong>guest</strong> account. To do this, someone already part of the workspace needs to invite the interested party or parties:</p> <ol> <li>In the Slack app, click the "ASF" header at the top left.</li> <li>Select <code>Invite people to ASF</code>.</li> <li>Use the<code>Single channel guests</code> option and, in the form that appears, provide the email addresses of the people you would like to invite to a specific channel.</li> </ol> <p>Infra has disabled the option that would let you provide a member invite link to the workspace to anyone who wanted it, as spammers were taking advantage of it. Projects can invite (single and multichannel guests) interested parties (via their <code>@dev</code> or <code>@users</code> lists or a note on their website) to send a request to join the channel either to the <code>@dev</code> list or to an email address the project specifies. The PMC can then extend an invitation to that person, if they choose. <a href="https://slack.com/help/articles/201330256-Invite-new-members-to-your-workspace" target="_blank">Slack has various ways to invite users to our workspace.</a></p> <h3>Slack Account Types</h3> <p>Slack has three account types:</p> <ul> <li><strong>Member</strong>: has full access to all Slack's features, including inviting others to join the workspace.</li> <li><strong>Multi-Channel Guest</strong>: has limited access inside Slack, but can join as many open channels as they wish.</li> <li><strong>Single-Channel Guest</strong>: can only access the channel they are invited to join.</li> </ul> <p>Slack has a list of <a href="https://slack.com/help/articles/201314026-Permissions-on-a-Slack-workspace" target="_blank">permissions</a> for these account types.</p> <h4>ASF and Slack 'members'</h4> <p>Both the ASF and Slack use the term 'member', but in different ways. The Slack use of "member" is above.</p> <p>For the Apache Software Foundation:</p> <ul> <li>An <a href="https://www.apache.org/foundation/how-it-works.html#asf-members" target="_blank">ASF Member</a> is a "person who was nominated by current members and elected due to merit for the evolution and progress of the foundation."</li> <li>A <a href="https://www.apache.org/foundation/how-it-works.html#pmc-members" target="_blank">PMC member</a> is a "developer or a committer that was elected" to the PMC.</li> </ul> <h2>Joining project channels</h2> <p>Once you are part of the ASF workspace as a member or a multi-channel guest, you can join any public channels you wish to.</p> <ul> <li>At the top of your list of channels in the Slack app, click the <strong>+</strong> icon.</li> <li>Use the <em>Browse channels</em> option to display a list of open channels in the workspace; or enter text in the search field.</li> <li>Select any channel to add it to your channel list.</li> </ul> <p>Some ASF channels are <strong>private</strong> or <strong>locked</strong>, 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.</p> <p>If you are a single-channel guest, you cannot join other channels.</p> <p>It is good manners to send a hello message to a channel you join, possibly with a short statement of why you are there.</p> <h2>Setting up a project channel</h2> <p>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.</p> <ul> <li>At the top of your list of channels in the Slack app, click the <strong>+</strong> icon</li> <li>Use the <em>Browse channels</em> option to see if the channel you are thinking of already exists. If you can't find it, click <em>Create Channel</em> at the top of the channels list; or use the <em>Create a channel</em> option under the + icon.</li> <li>After you provide a name for the channel, you can set it as <strong>public</strong>, so any member of the ASF can see and join it, or <strong>private</strong>, as noted above. People can only join a private channel by invitation.</li> </ul> <p>If you <em>do</em> 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.</p> <h2>Shared channels</h2> <p>Slack shared channels operate like regular channels, except that they are open to participation by people from two different organizations (such as two companies, or a company and a user group). The ASF does not permit shared channels in its space.</p> <h2>Making information on private channels public</h2> <p>People participate in a private channel with the understanding that it is, and will continue to be, private. They may share material there that they would not want, or do not have the right to, make generally available. Therefore, Infra's policy is <strong>not</strong> to make private channels public.</p> <p>If there is information on a private channel that the channel members, <strong>without exception</strong>, would like to share publicly with the whole project, Infra recommends that you:</p> <ol> <li>Create a summary of the material to be shared in a text document, removing all personally identifiable information (PII) and third-party information, and summarizing the information and conclusions reached without copying and pasting. <strong>Note</strong> that PMCs must take any formal decisions and votes on the project's mailing list, not in a Slack channel.</li> <li>Copy the material in the summary document and paste it in a comment in a public channel for the project (create a new public channel if you do not have one for which the information would be relevant). OR</li> <li>Save the summary document to your project wiki or some other accessible space and use the "add a bookmark" tool at the top of the public channel display to provide a link to the document so readers can find it easily.</li> </ol> <h2>Qbot</h2> <p>The Infrastructure team's Qbot is a Slack assistant that can simplify both important and frivolous tasks on Slack channels in the the-asf workspace. It can support requests in channels for PMCs, ASF committees, the ASF Board and ASF Members.</p> <p><a href="qbot.html">Learn more here</a></p> <h2>Expectations</h2> <p>As with all ASF activities, we expect ASF Members and project participants to conduct themselves according to the ASF <a href="https://www.apache.org/foundation/policies/conduct.html" target="_blank">Code of Conduct</a>.</p> <p>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.</p> </div> </div> </div> <!-- footer --> <div class="row"> <div class="large-12 medium-12 columns"> <p style="font-style: italic; font-size: 0.8rem; text-align: center;"> Copyright 2024, <a href="https://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br/> Apache® and the Apache feather logo are trademarks of The Apache Software Foundation. </p> </div> </div> <script type="application/ecmascript" src="/js/bootstrap.bundle.min.js" integrity="sha384-OERcA2EqjJCMA+/3y+gxIOqMEjwtxJY7qPCqsdltbNJuaOe923+mo//f6V8Qbsw3"></script> </div> </main> <script>hljs.initHighlightingOnLoad();</script> </body> </html>