Swag Proposal for Open Mainframe Project Slack to Reduce Channel Pollution

[jmertic]

From @lbdyck:

Overview

Open Mainframe Project maintains a Slack workspace (Slackspace) for use by Open Mainframe Project and by the approved, and sponsored, projects. Within the Slackspace are channels for use by everyone such as the general channel, and channels for specific projects such as the Cobol-programming-course. When one channel is used by those who should be using another channel the result is channel pollution. In many cases this occurs due to ignorance on the part of the user as a result of the user not being aware of the proper use of the various channels.

Proposal

To reduce Slack channel pollution, I’m proposing the following steps to occur:

Project Onboarding Webpage

On the Open Mainframe Project site there should be a page with a list of projects and under each project should be pages with more information on the project. One of those pages should be Slack usage guidelines. The guidelines may include:

1. Post all questions, issues, etc. regarding the project in the projects Slacks channel.
2. Keep sensitive information out of the channel – if that is needed then use a direct message
3. Slack instructions on how to use DMs
4. Do not use the General channel for project related posts

   Update the Individual Project Slack Channels with a Bookmark

   Slack supports creating a bookmark that is available at the top of each channel, and is unique to that channel. A bookmark referencing the usage guidelines should be placed on each channel that points to the usage guidelines for that project.

ACTION: Please use this thread as a way to discuss and refine the approach. Thank you!

[lbdyck]

One thing each channel owner needs to be aware of is the use of pinned discussions. The pin works while the discussion is active but it appears that the OMP Slackspace is on the free level which means that all discussions go away after 90 days and at that time the pin should go away - I haven't tested this but am doing so now. I pinned something from Jan 30 and it should roll off on 4/30 or perhaps 5/1. I'll update with results.

[lbdyck]

I found that some pinned items from over a year ago are visible when you click the pinned button - you can view the pinned item in the pinned list but if you click the item to view it then the original post is not visible - thus it remains in the archive and will be available if the slack account is upgraded - otherwise it remains hidden.

[tanto259]

I have no objections to any kind of usage guideline being prominently placed on the Open Mainframe Project's website. However, I believe the invite link to the Slack workspace is everywhere on the internet and we need to figure out how we can properly communicate the guideline to new users joining from other sources.

Some other proposals I have in mind:

• Restricting the #general channel to strictly posts by project committers and admins, so it should only be used for announcement or as a directory list to point users to the respective channels. This should be possible on the free Slack plan. It's a bit of a drastic measure, but right now everyone is automatically added to #general and there is no way to customize this behavior on the free Slack plan. We can then have another channel for workspace-wide discussions.

• Checking if GreetBot is still working, I believe it should have send every new users a DM with information.

• If for some reason we are able to get a Slack paid plan, it should be possible to set is such that invite links would be customizable to select default channels that new users will be automatically added to.

[lbdyck]

While the invite link is public and easily available to those who find it, the key is that individuals who join need to understand the participation guidelines which is not readily available at this point (at least I didn't find any).

1. I'm not a fan of locking down the general channel but it does need to have the fluff removed/limited.
2. I'm not familiar with GreenBot but having read up on it just now it does look worthwhile to implement and to provide the guidelines to new users
3. +1

While having guidelines is no guarantee that they will be read, understood, or followed, it is a start.

My $0.01 (not sure they are worth $0.02)

[tanto259]

1. I'm not a fan of locking down the general channel but it does need to have the fluff removed/limited.

Neither do I, but at this point it seems that many people would post stuff there without checking for the appropriate channel. It's been like that for a while and I sometimes noticed that important questions that people have for other projects got buried with all of the "fluff".

Not sure if there are any good (and free) way we can moderate posts there... I don't think Slack have any good moderation tools for large public communities...

2. I'm not familiar with GreenBot but having read up on it just now it does look worthwhile to implement and to provide the guidelines to new users

This is what is GreetBot should have posted to every new joins via DM. If you checked the link for the Slack Guidelines and Code of Conduct, it leads to a 404. So definitely need to update those links... There is some sort of a guideline at https://tac.openmainframeproject.org/tools/slack.html. But I agree with your suggestion that we probably need a more comprehensive one.

Then again, as you said, no guarantee that people will read the DM that GreetBot sent.

Welcome to the Open Mainframe Slack Workspace!

This workspace is for general discussion amongst Open Mainframe Project members and the broad community. Review the Slack Guidelines and follow the Open Mainframe Summit Code of Conduct. Here are some key channels to get started in.

Check out the below channels for specific projects and working groups hosted at OMP...

#ambitus - Ambitus #ade - ADE #atomplugins - Atom language syntax highlighting for z/VM #cobol-check - COBOL Check #cobol-programming-course - COBOL Programming Course #wg-cobol - COBOL Working Group #consolez - ConsoleZ #cbt-tape - CBT Tape #feilong - Feilong #genevaers - GenevaERS #omp-education-project - Mainframe Open Education #mentorship - Mentorship program #wg-open-zos-enablement - Open z/OS Enablement #polycephaly - Polycephaly #software-discovery-tool - Software Discovery Tool #tersedecompress - TerseDecompress #tessia - Tessia #zorow - Zorow #zowe-user or #zowe-dev - Zowe

Other good channels to check out....

#academic - Discussion for students or those in academia #marketing - Events and other outreach happening #socialmedia - Share posts we can reshare on the OMP Twitter and LinkedIn #linuxone - Discussion on Linux on Z #zos-beginners - z/OS discussion #zosmf-adoption - z/OSMF discussion

Feel free to reach out to @jmertic or @Maemalynn if you have any questions or need assistance.

[jmertic]

ACTIONS:

• Each project needs to establish and maintain its guidelines for each of its channel purposes, and guidelines posted as the subject/pin for each channel.
• Do analytics report on channel usage.
• Get a full list of channels for the group to review.
• Investigate automation tools to direct users out of general for messages, along with ways to better inform users of where to go.

[jmertic]

See attached full list of channels and analytics for the past 5 years:

slack_main_channels.csv

[jmertic]

@lbdyck is coming up with recommendations for using Greetbot

[lbdyck]

strawman for GreenBot:

{{members}} welcome to the Open Mainframe Project (OMP) Slack workspace that hosts channels specific to individual OMP sponsored activities and projects. Please refer to this page for specifics on best practices so that you will get the most benefit from this workspace.

One key thing to keep in mind with the number of available channels is to find the channel that most closely aligns with your reason for being here and then use that channel for your questions and posts.

[jmertic]

Action: Projects review their channels and update. Revisit in a few months.

[lbdyck]

It appears that Slackbot - which is already included - could help in some areas.

See more here https://slack.com/help/articles/202026038-An-introduction-to-Slackbot

One thing is it has the ability to generate an auto-response when keywords are found.

[jmertic]

@lbdyck Is there anything else to do here?

[lbdyck]

let's close it