Skip to content

Commit cc33cde

Browse files
juanis2112sanketverma1704InessaPawson
committed
Add community guide
Co-authored-by: Sanket Verma <[email protected]> Co-authored-by: Inessa Pawson <[email protected]>
1 parent a515d4a commit cc33cde

21 files changed

+242
-290
lines changed

content/community/.DS_Store

0 Bytes
Binary file not shown.

content/community/_index.md

Lines changed: 8 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -3,48 +3,11 @@ title: "Community Guide"
33
shortcutDepth: 2
44
---
55

6-
{{< notice warning >}}
7-
This is a draft document.
8-
{{< /notice >}}
9-
10-
Welcome to the Community Guide! Here you will find useful resources that will help you get familiar with the Scientific Python community.
11-
12-
## Community interviews
13-
14-
Meet some of the members of the Scientific Python community.
15-
16-
{{< youtube page="melissa-webber" levelOffset=3 >}}{{< /youtube >}}
17-
18-
{{< youtube page="dan-schult" levelOffset=3 >}}{{< /youtube >}}
19-
20-
{{< youtube page="alex-desiqueira" levelOffset=3 >}}{{< /youtube >}}
21-
22-
{{< youtube page="kira-evans" levelOffset=3 >}}{{< /youtube >}}
23-
24-
{{< youtube page="ross-barnowski" levelOffset=3 >}}{{< /youtube >}}
25-
26-
{{< youtube page="isabela-presedo" levelOffset=3 >}}{{< /youtube >}}
27-
28-
{{< youtube page="pamphile-roy" levelOffset=3 >}}{{< /youtube >}}
29-
30-
## Join the community
31-
32-
Scientific Python is community driven since projects are developed and maintained by open source communities. This is why we are looking for ways to expand our community in a welcoming and inclusive way. We have several ways for you to join us:
33-
34-
### Discussions
35-
36-
Join the discussion on our [Discord server](https://discord.gg/vur45CbwMz) and on [Discourse](https://discuss.scientific-python.org). We want everyone to share their perspective with all the members of our community!
37-
38-
### Social media
39-
40-
Follow us on our social media channels and share our content with the community!
41-
42-
![socials youtube](icons/youtube_icon.svg) [ScientificPython-org](https://www.youtube.com/ScientificPython-org)
43-
44-
![socials twitter](icons/twitter_icon.svg) [@scientific_py](https://twitter.com/scientific_py)
45-
46-
![socials facebook](icons/facebook_icon.svg) [scientific.python](https://www.facebook.com/scientific.python)
47-
48-
![socials instagram](icons/instagram_icon.svg) [scientific.python](https://www.instagram.com/scientific.python/)
49-
50-
![socials tiktok](icons/tiktok_icon.svg) [@scientific.python](https://www.tiktok.com/@scientific.python)
6+
Welcome to the Community Managers Guide! Here you will find useful resources that will help you foster your community better.
7+
8+
- [Community Manager Role]({{< relref "/contributors/role" >}})
9+
- [Skills and Techniques]({{< relref "/contributors/skills" >}})
10+
- [Community Meetings]({{< relref "/contributors/community-meetings" >}})
11+
- [Community Outreach]({{< relref "/contributors/community-outreach" >}})
12+
- [Onboarding]({{< relref "/contributors/onboarding" >}})
13+
- [Project Management]({{< relref "/contributors/project management" >}})

content/community/alex-desiqueira.md

Lines changed: 0 additions & 7 deletions
This file was deleted.
Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
---
2+
title: "Community Meetings"
3+
---
4+
5+
## How to initiate a community meeting?
6+
- Before starting the meeting, having a few items and discussion points in the agenda will help kick-start the meeting. These discussion points could be a mix of:
7+
- Issues or PRs from the GitHub repositories which need attention
8+
- Announcing any upcoming events/conferences to check if someone is going to attend them or is planning to
9+
- Important updates:
10+
- These could be recent releases/new feature additions
11+
- Addition/changes in the maintainer/contributor team
12+
- Convergence of an ongoing discussion - a summary of how the community reached a decision
13+
- Anything important which needs to be brought up before the community
14+
- Let everyone know that the meeting is governed by a CoC
15+
16+
## Ice-breakers
17+
- Ice-breakers are usually effective when the participants are not familiar with each other
18+
- Apart from the general introduction, which is usually name and role, it’s effective to add a fun question (generally non-technical) to ask around; these are:
19+
- Favourite song, movie, dish, sport, game, tourist spot etc.
20+
- If you could teach the world one thing, what would it be?
21+
- What’s one interesting fact about yourself?
22+
23+
## How to address any critical issues in the project/community
24+
- Sometimes, there are certain matter which needs to be brought up before the community for a more open and inclusive discussion
25+
- This helps in taking into account various perspectives from the community and choosing a solution which is in the best interest of the community
26+
27+
## How to keep the conversation going?
28+
- Occasionally, there are situations when the conversation during a community meeting dies, and it feels like you’re in a graveyard 🪦
29+
- Having a set up of backup discussion points can help remove the awkward silence
30+
- Going around in the audience to ask if they have something interesting to share with the community
31+
- What projects are they working on?
32+
- Something they learned which could be shared with the community
33+
- Asking around if the attendees need any help
34+
35+
## How to conclude the meeting successfully
36+
- The meeting should end on a positive note - if there has been any heated discussion/arguments, try to conclude before the end. And generally, in the end, you should:
37+
- Conclude important points
38+
- Revise tabled items - which were supposed to be discussed but didn’t get time
39+
- Tell them about the next meeting
40+
41+
## How to run office hours?
42+
- Office hours are a great way to invite the community and answer their questions, guide them, help them understand any specific about your OSS project etc.
43+
- Usually, the structure of office hours is open, but there are certain tips which could make it run smoother; they are:
44+
- Greet and acknowledge every participant during the office hours
45+
- Try to answer at least 1 question from everyone
46+
- Maintain a document so that everyone can jot down their questions, so it’s easier to go through them
47+
- Invite them to the community meetings for broader discussions
48+
49+
## How to take meeting notes?
50+
- Every community meeting should have some form of public record which can be stored as an archive - taking meeting notes is one way to do it. There are several ways to take notes efficiently, which is helpful for the community
51+
- Record the essential things, decisions, and resolutions that were discussed during the meeting
52+
- Writing cues during the meeting and then converting them into proper sentences is a helpful thing to do when you’re moderating/running the meeting
53+
- Try to have a TL;DR section at the top - this would help the reader to decide if they want to dive into the full notes or not
54+
- Example at: https://zarr.dev/community-calls/2023/2023-05-03.html
55+
56+
## Some tips for your meetings
57+
58+
- Make time for demos/showcases/presentation
59+
- The community members are always looking for exciting/innovative ways to use OSS projects in their workflow, and making time to showcase the work is a good element of a community meeting
60+
- The demos/showcases could be - how your project is used to solve a problem in a specific domain
61+
- Make time for newcomers
62+
- New contributors or newcomers are the users who have the potential of becoming future maintainers and helping them in the initial phase is beneficial for both the project and the individual and is in the spirit of open-source
63+
- Having a dedicated time slot for the newcomers to help them
64+
- Make community meetings accessible to the broader community
65+
- Take into account community members in different time zones, differently abled, unavailability etc.
66+
- Take notes and upload them to the website
67+
- Record the meeting
68+
69+
## Meeting templates (TODO)
70+
[NumPy Community Meeting template](https://hackmd.io/76o-IxCjQX2mOXO_wwkcpg)
Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
---
2+
title: "Community Outreach"
3+
---
4+
5+
# Community Outreach
6+
7+
## Outreaching to Social Media
8+
Use various social Media channels for outreach:
9+
- Twitter:
10+
- Utilize hashtags relevant to the scientific Python community to increase visibility.
11+
- Engage with users by responding to questions, sharing resources, and participating in discussions.
12+
- Retweet and mention influential users and organizations to foster connections.
13+
- Share updates on project releases, new features, and bug fixes.
14+
- Highlight community contributions and achievements.
15+
16+
- LinkedIn:
17+
- Create a LinkedIn group for the project to facilitate networking and discussions among professionals.
18+
- Share project updates, news, and job opportunities.
19+
- Encourage community members to share their experiences and insights related to the project.
20+
- Connect with other professionals and organizations in the scientific Python field.
21+
22+
## Tools for community outreach(TODO)
23+
24+
## Speaking at Conferences and Events:
25+
- Submit proposals to relevant conferences, emphasizing the project's unique features and benefits.
26+
- Prepare engaging presentations that demonstrate the project's capabilities and use cases.
27+
- Provide live demos or tutorials to showcase the project in action.
28+
- Connect with attendees during and after the event, answer their questions, and collect feedback.
29+
30+
## Teaching Tutorials
31+
- Organize regular online tutorials or sprints to educate the community about using the project.
32+
- Cover various skill levels, from beginners to advanced users.
33+
- Provide clear documentation and code examples.
34+
- Encourage community members to share their own tutorials and best practices.
35+
36+
## Writing Blog Posts:
37+
- Keep the community updated on important news, such as project milestones, partnerships, and funding.
38+
- Announce major releases, highlighting new features and improvements.
39+
- Share technical insights, tips, and tutorials related to the project.
40+
- Recognize and appreciate community contributors through dedicated blog posts.
41+
42+
## Creating content
43+
- Create video tutorials, screencasts, or live coding sessions to demonstrate the project's usage.
44+
- Develop interactive Jupyter notebooks showcasing practical applications.
45+
- Produce podcasts or interviews with community members or domain experts.
46+
- Collaborate with other scientific Python projects for joint content creation, such as tutorials or blog posts.
47+
- Create illustrations on how your project works: https://github.com/zarr-developers/zarr-illustrations-falk-2022

content/community/dan-schult.md

Lines changed: 0 additions & 7 deletions
This file was deleted.

content/community/icons/.DS_Store

-6 KB
Binary file not shown.

content/community/icons/facebook_icon.svg

Lines changed: 0 additions & 1 deletion
This file was deleted.

content/community/icons/instagram_icon.svg

Lines changed: 0 additions & 95 deletions
This file was deleted.

0 commit comments

Comments
 (0)