Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

slack handbook section - initial #59

Merged
merged 4 commits into from
May 31, 2024
Merged

Conversation

kierisi
Copy link
Contributor

@kierisi kierisi commented May 3, 2024

initial text for the Slack section of the pyOpenSci handbook. @lwasser if you could review, but also check the section on adding automated GitHub feeds to Slack, that would be great. I haven't (yet) set up a GitHub feed to Slack, so I'm not sure if these instructions are still accurate, or if they're clear enough.


@kierisi
Copy link
Contributor Author

kierisi commented May 3, 2024

pre-commit.ci autofix

## Setting up a Slack bot using Slack Workflows
Administrators in the pyOpenSci Slack space can set up [workflows](https://slack.com/help/articles/16583775096083-Automations--What-is-a-Slack-workflow), which are automated bots that complete tasks based on automatic triggers. We currently use a workflow to onboard new members to the Slack space, and if there are additional bots you feel would be helpful, please reach out to Leah or Jesse.

## Setting up an automatic feed to post from GitHub into Slack:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here are a few note

  • The slack integration settings can be found here in GitHub. IF YOU HIT THE configure button, it will allow you to configure which repositories are available to the slack / github integration bot.
Screenshot 2024-05-30 at 2 46 37 PM

@kierisi the part that i can't remember here is how i initially set this up. It may have been by calling a command in slack which lead me to the initial setup. Or i may have started on this website where you can add the bot to an organization?

does that help? the commands below that you wrote out look correct to me.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lwasser that helps! it looks like the link you've shared is the way to go in order to set up the integration for the overall slack workspace, so I can update everything!

Copy link
Member

@lwasser lwasser left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@kierisi this looks great. i've left a few comments and some information on the slack integration. id say make those edits and then please merge. If you need more info from me on slack please also say the word! But i'm approving this to be merged!

Comment on lines 29 to 30
* Everyone invited to Slack has generally already contributed to pyOpenSci in some way, and therefore have a vested interest in the community upon joining.
### Who we invite to the community:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* Everyone invited to Slack has generally already contributed to pyOpenSci in some way, and therefore have a vested interest in the community upon joining.
### Who we invite to the community:
* Everyone invited to Slack has generally already contributed to pyOpenSci in some way, and therefore have a vested interest in the community upon joining.
### Who we invite to the community:

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it's a good idea to have a full line break after a section heading. can you please fix this throughout? sphinx might allow it but generally we want a return before a new heading for readability too!

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yes! I'll get that sorted - thanks for flagging!

### Who we invite to the community:
We invite people to Slack who have contributed to pyOpenSci in some way. This can include attending and contributing via a sprint, submitting a package (normally this happens after the package has been accepted, but may occur earlier on an ad-hoc basis. Invites are rarely sent before the review is finished), being a reviewer or editor, contributing to a guidebook, or signing up to become involved. Often if someone signs up we meet with them prior to sending a Slack invitation.

We also occasionally invite people that would be valuable contributors to our community in some way, even if they haven’t already contributed! These might be people who express interest in work we are doing and who want to learn more or get involved.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We might also invite people who are from partner community and/or are doing work that is mission aligned!


We have also strategically invited people with expertise in the field, including core packaging experts, community members and others with knowledge that is incredibly valuable to our community’s development.
### How we invite new community members
Generally speaking, the Executive Director invites individuals who have not already contributed to pyOpenSci. These invitations are at their discretion, while package developers are usually invited by a pyOpenSci editor as part of the review process.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a note - ROS i think has the community manager invite people after reviews are done. i think they do it on fridays. we can feel out what works best here of ourse!

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lwasser I have a calendar reminder to check our membership every Thursday (to grab folks that have been invited by editors so I can do a welcome post). I don't have insight into the review process at this point in terms of who's reviewing a package. would keeping an eye on github work? or do you have a suggestion for the best place to get that information?

community/slack.md Outdated Show resolved Hide resolved
kierisi and others added 2 commits May 30, 2024 21:26
accepted changes

Co-authored-by: Leah Wasser <[email protected]>
@kierisi kierisi merged commit 3b77278 into pyOpenSci:main May 31, 2024
2 of 3 checks passed
@kierisi kierisi deleted the slack-handbook branch May 31, 2024 02:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants