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

Volunteerguide #40

Merged
merged 7 commits into from
Feb 14, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions index.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,8 @@ Welcome! Data Umbrella is organizing a couple of workshops/events followed by a

webinars/index
sprint/index
sprint/sprint-guide
about/index
contributing/index

:::
4 changes: 2 additions & 2 deletions sprint/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,8 +95,8 @@ background.
[Register here](https://www.meetup.com/data-umbrella/events/283766699/)
* Get extra live feedback on the PRs you opened but didn't manage to merge during the
sprint, and advise on how to continue contributing to PyMC!

## Sprint Guide
## Guide to your first contribution

Below you can already see the guide to your first contribution.
You should make sure to have all the programs in the prereqs section available on your computer
Expand Down
50 changes: 50 additions & 0 deletions sprint/sprint-guide.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
(sprint_guide)=
# Sprint Guide

Here are some guidelines and suggestions about the sprint for participants and volunteers!

## General Information

- Be Polite
- Ask questions
- Don't use any discriminatory terms
- Use gender neutral pronouns unless you know someone's preferred pronouns
- Don't use words like "guys", instead say "folks" or "people"
- Be inclusive and kind

The sprint will be happening on Zoom, the sign up instructions are available on Meetup, please try to join on the starting time so you can recieve proper help and guidance for the sprint. There will be breakout rooms inside the Zoom call that participants will be assigned to:
- Women and Non binary folks: this breakout room is specifically for women and non binary folks, we hope you have a meaningful space here where you're heard!
Copy link
Member

Choose a reason for hiding this comment

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

I have mixed feelings about the wording. Maybe it's just me but I can see this being interpreted as women and non binary folks will only be heard here

- New to open source: this breakout room is for newcomers to open source so you can get suitable help
- Code related PR: If you are making a code related contribution then you'll be assigned to this breakout room
- Documentation related PR: If you are making a Documentation related contribution then you'll be assigned to this breakout room
- Spanish Speaker: If you prefer spanish over english to communicate this breakout room will be useful, Oriol Abril Pla (one of our PyMC volunteers) will be there to help you out
Copy link
Member

Choose a reason for hiding this comment

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

I was planning on hosting the spanish breakout room on the America event only, and participate as a "regular" volunteer in the other session. Would that work? I am not sure how much time/jumping between rooms I'd be supposed to do


These breakout rooms aren't rigid, you can choose which one you wish to be in, they're created solely to help us help you!
Copy link
Member

Choose a reason for hiding this comment

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

is there a page on zoom docs on how to do this? we have a use discord 10 min video, we probably need some use zoom reference (no need to make a specific video)


## Volunteer Guide
Copy link
Member

Choose a reason for hiding this comment

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

I'd probably separate volunteer info from participant info (i.e. the volunteer info can be in "help with the sprint").


1. Breakout rooms will be created at the begining of the meeting, but do join 15 minutes before the sprint so you can get the hang of Zoom and these rooms to make things smoother.
2. Feel free to create new breakout rooms, if needed.
3. Be patient and kind to sprint participants, if you feel unable to help someone with a doubt or issue, redirect it to another volunteer or PyMC team member if someone is available. If that does not work, consider suggesting a new issue to the participant.
4. Encourage people to introduce themselves and ask questions.
5. Do flag any(really ANY) inappropriate behaviour. Warn the participant or remove them from the Zoom meeting in these cases:

- They make a discriminatory remark
- They are being persistently rude
- They are a spammer

### Tentative structure of the Sprint
Copy link
Member

Choose a reason for hiding this comment

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

not sure if this is for volunteers, for participants or for both.


- All participants join, the first 5-10 mins are spent with everyone introducing and saying hi
- Participants are redirected to the board consisting of available issues that they can choose [from here](https://github.com/pymc-devs/pymc/projects/4)
Copy link
Member

Choose a reason for hiding this comment

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

I have said it multiple times already but I would recommend very strongly that everyone does a docstring update as first PR and work on other issues as 2nd contribution. I'd therefore show only the docstring tutorial link if participants are to read this (which might be a bit too harsh, I don't know) but I think both should be here at the very least, otherwise the docstring contributions get a bit lost as "one more issue" when they have guidance so much more detailed than any of the other issues, and it can provide contributions for all participants by itself.

- If a participant doesn't find a suitable issue here they're encouraged to ask the volunteers for help, who will suggest an issue or task based on their said skills
- Participants go to breakout rooms and work on their issues, they should make a comment on the issue they're interested in, after which volunteers will update that issue on the Sprint Dashboard for clarity.
Copy link
Member

Choose a reason for hiding this comment

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

Careful here because there are several issues on which multiple people can work at the same time

- Volunteers keep alternating between breakout rooms to checkup on Participants, to see if they need help
- Participants can either wait for someone to come to their breakout room, or text on the discord channel or Zoom chat

Cheers, have fun folks!

[Sprint Organizers](https://github.com/pymc-devs/pymc/projects/4)



2 changes: 1 addition & 1 deletion webinars/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# Webinars
We will be hosting a series of webinars to help you prepare for the sprint.
We will be hosting a series of webinars to help you prepare for the sprint. You can find them in this Youtube Playlist for [PyMC Series](https://www.youtube.com/playlist?list=PLBKcU7Ik-ir99uTvN0315hIVLuyj4Q1Gt)

:::{include} table_of_events.md
:::
Expand Down
23 changes: 17 additions & 6 deletions webinars/table_of_events.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,23 @@

| Name of Event | Date of Event | Time of Event | Duration | Speaker | Registration form |
|-------------------------------|----------------------|---------------|---------------|-------------------|---------------------|
| {ref}`array_ops` ** | November 11, 2021 | 5pm UTC | 60+30 minutes | [Meenal Jhajharia](https://mjhajharia.com) | - |
| {ref}`array_ops`[^1] | November 11, 2021 | 5pm UTC | 60+30 minutes | [Meenal Jhajharia](https://mjhajharia.com) | - |
| {ref}`probprog_pymc` | January 11, 2022 | 5pm UTC | 45 minutes | [Austin Rochford](https://austinrochford.com) | - |
| {ref}`contributing_to_pymc` | January 28, 2022 | 5pm UTC | 45 minutes | [Ricardo Vieira](https://github.com/ricardoV94) | - |
| {ref}`contributing_docs` | February 8, 2022 | 5pm UTC | 45 minutes | [Oriol Abril](https://oriolabril.github.io) | - |
| {ref}`Pre Sprint <sprint/schedule>`| February 11, 2022 | 3pm UTC | 1 hours | PyMC Team | [meetup event](https://www.meetup.com/data-umbrella/events/283765923/) |
| {ref}`sprint` slot 1 | February 18, 2022 | 7pm UTC | 2 hours | PyMC Team | [meetup event](https://www.meetup.com/data-umbrella/events/283178769/) |
| {ref}`sprint` slot 2 | February 19, 2022 | 10am UTC | 2 hours | PyMC Team | [meetup event](https://www.meetup.com/data-umbrella/events/283178769/) |
| {ref}`Post Sprint <sprint/schedule>`| February 25, 2022 | 3pm UTC | 1 hours | PyMC Team | [meetup event](https://www.meetup.com/data-umbrella/events/283766699/) |
| [Example PR to PyMC](https://www.youtube.com/watch?v=NbmdFJsnuuo) | - | - | 20 minutes | [Reshama Shaikh](https://reshamas.github.io) | - |
| [Bayesian Modeling with PyMC3](https://www.youtube.com/watch?v=6dc7JgR8eI0)[^2] | - | - | 45 minutes | [Oriol Abril](https://oriolabril.github.io) | - |

[^1]: Only for people who need additional help with python, but are already familiar with at least one programming language

[^2]: This is an old (but useful) resource, it uses PyMC3, check {ref}`contributing_to_pymc` for an introduction to PyMC 4.0


# Sprint

** Only for people who need additional help with python, but are already familiar with at least one programming language
| Name of Event | Date of Event | Time of Event | Duration | Registration form |
|-------------------------------|----------------------|---------------|---------------|---------------------|
| {ref}`Pre Sprint <sprint/schedule>`| February 11, 2022 | 3pm UTC | 1 hours | [meetup event](https://www.meetup.com/data-umbrella/events/283765923/) |
| {ref}`sprint` slot 1 | February 18, 2022 | 7pm UTC | 2 hours | [meetup event](https://www.meetup.com/data-umbrella/events/283178769/) |
| {ref}`sprint` slot 2 | February 19, 2022 | 10am UTC | 2 hours | [meetup event](https://www.meetup.com/data-umbrella/events/283178769/) |
| {ref}`Post Sprint <sprint/schedule>`| February 25, 2022 | 3pm UTC | 1 hours | [meetup event](https://www.meetup.com/data-umbrella/events/283766699/) |