You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _posts/2024-06-20-pyconus-pyopensci-sprints.md
+30-30Lines changed: 30 additions & 30 deletions
Original file line number
Diff line number
Diff line change
@@ -104,7 +104,7 @@ These barriers include:
104
104
* Time to contribute.
105
105
* Skills to contribute.
106
106
* Confidence in skills / fear of contributing the wrong thing.
107
-
* Privilege: This is a loaded one. Open Source can't be diverse if it requires privilege
107
+
* Privilege: This is a loaded one. Open Source can't be diverse if it requires privilege.
108
108
to participate.
109
109
110
110
And last but not least:
@@ -122,8 +122,8 @@ including:
122
122
* Learning and growing skills that may not be accessible in your day job.
123
123
* Connecting with other developers, data scientists, and scientists in the community.
124
124
* Engaging and being part of an online community or maintainer team.
125
-
* Growing your professional network
126
-
* Learning about a new project
125
+
* Growing your professional network.
126
+
* Learning about a new project.
127
127
128
128
Or, maybe you're like me—an Executive Director of a community organization. Coding and
129
129
development aren't in my job description, but to teach these topics, I need to keep my
@@ -139,17 +139,17 @@ skills fresh. And, I love to code. That's where Open Source comes into my life!
139
139
140
140
So how do we align the challenges that contributors face with the potential opportunities?
141
141
142
-
While new contributor sprints are not for everyone and assume some level of privilege
142
+
While new contributor sprints are not for everyone, and assume some level of privilege
143
143
in having the time and bandwidth to participate, they can be great for many.
144
144
145
145
But a sprint will only be a good experience if the contributor's needs and goals are also considered. Contributors need to gain something
146
146
from contributing, and this requires:
147
147
148
-
* time and care in designing the sprint and
149
-
* time spent with new comers during the sprint.
148
+
* time and care in designing the sprint, and
149
+
* time spent with newcomers during the sprint.
150
150
151
-
It's also important to note that this time required, is also a privilege for
152
-
many if not most maintainers who are already volunteering their time to maintain
151
+
It's also important to note that the time required to participate is also a privilege for
152
+
many, if not most, maintainers who are already volunteering their time to maintain
153
153
a project! As such we can't expect all open source packages to be able to
154
154
support beginner contributions in a comprehensive way.
155
155
@@ -163,23 +163,23 @@ learner motivations. For me personally, contributing to Open Source met two of m
163
163
and interests:
164
164
165
165
***Applied (project-based) learning:** I love to learn. Coding and data science are my
166
-
happy places. But the learning needs to be directly applicable. If it isn't, I get bored. But moreover, if I can't see the application of the skill, I have little motivation to learn that skill!
166
+
happy places. But the learning needs to be directly applicable. If it isn't, I get bored. Moreover, if I can't see the application of the skill, I have little motivation to learn that skill!
167
167
***Student-directed learning:** I love to learn on my own time, following my own
168
168
processes that work for me. Open Source allows me to do just that (and without the
169
169
pressures of a specific deadline in most cases).
170
170
171
171
If you read the education literature, you will find both project-based learning and student-directed learning to be
172
-
a commonly discussed topic - especially as it relates to empowering people who are underrepresented in a space.
172
+
a commonly discussed topic—especially as it relates to empowering people who are underrepresented in a space.
173
173
174
174
More on that next...
175
175
176
176
### The power of project-based learning
177
177
178
178
[Project-based learning](https://www.wpi.edu/project-based-learning/why-pbl) is
179
179
founded on the idea that meaningful, applied projects are
180
-
the best way to teach a topic. This works especially well in the data science space and
180
+
the best way to teach a topic. This works especially well in the data science space, and
181
181
has been found to be particularly effective with underrepresented groups. In
182
-
fact I implemented and collected data on this in a [previous project](https://www.leahwasser.com/training-diverse-communities-earth-data-science-corps)
182
+
fact, I implemented and collected data on this in a [previous project](https://www.leahwasser.com/training-diverse-communities-earth-data-science-corps)
183
183
that I designed and ran when I was in academia.
184
184
185
185
@@ -193,7 +193,7 @@ outcome.
193
193
It's similar to how you can immediately engage a diverse audience in GIS (spatial data) with Google
194
194
Earth by asking them to zoom into the area where they live (place-based learning).
195
195
196
-
As a volunteer maintainer of Stravalib, I am motivated to work on stravalib
196
+
As a volunteer maintainer of [Stravalib](https://github.com/stravalib/stravalib), I am motivated to work on stravalib
197
197
because I learn in a very applied way.
198
198
199
199
Sure, a sprint does not have the powerful outcome of a student understanding the
@@ -202,8 +202,8 @@ impacts of climate change on their local tribal lands. But the concept is the sa
202
202
> The learning motivation comes from a meaningful outcome that a student wants or cares
203
203
about.
204
204
205
-
In leading a sprint, asking that question of "what are your goals for today"
206
-
will help you as a sprint leader to direct their efforts towards a successful path.
205
+
In leading a sprint, asking the question of "what are your goals for today?"
206
+
will help you as a sprint leader to direct sprinter efforts down a successful path.
207
207
208
208
### The power of student-directed learning
209
209
@@ -212,7 +212,7 @@ taught people the same way: in a classroom, using the same books and approaches.
212
212
However, alternatives to this model allow learners to adapt their environment to their personal and learning goal needs.
is based on the idea that people learn differently and have different needs. By creating
215
-
a hybrid learning environment where students are allowed to pick their learning path and approach, you empowering them to own their experience.
215
+
a hybrid learning environment where students are allowed to pick their learning path and approach, you empower them to own their experience.
216
216
217
217
Some learners benefit from hands-on demos, whether in a classroom or at the sprint
218
218
table. They may pick things up quickly or need to watch and digest the demo. Others
@@ -228,12 +228,12 @@ Contributors at the sprint can decide if they need direction, mentorship, or jus
228
228
short tutorial/guidebook for making their first contribution using the GitHub
229
229
interface.
230
230
231
-
### Collaborative git and GitHub lessons
231
+
### Collaborative Git and GitHub lessons
232
232
233
-
This past year, I was awarded the BSSwfellowship in which I proposed lessons on these lesser known collaborative,
234
-
git and GitHub skills - the same skills that will support people attending sprints! I am looking forward to having these lessons on hand,for next year's sprints, to support those who are still fighting to learn git and GitHub (it can be an uphill process!).
233
+
This past year, I was awarded the [Better Scientific Software (BSSw) Fellowship](https://bssw.io/pages/bssw-fellowship-program), in which I proposed lessons on these lesser known collaborative
234
+
Git and GitHub skills—the same skills that will support people attending sprints! I am looking forward to having these lessons on han ,for next year's sprints, in order to support those who are still fighting to learn Git and GitHub (it can be an uphill process!).
235
235
236
-
## The Anatomy of a pyOpenSci Sprint
236
+
## The anatomy of a pyOpenSci sprint
237
237
238
238
Based on my understanding of the learning motivations and challenges that new
239
239
contributors face, I've developed a pyOpenSci sprint approach that I've found to
@@ -270,7 +270,7 @@ A good sprint begins with useful, labeled issues. The information in the body of
270
270
an issue is critical. Be sure to include the specific details of the issue
271
271
to be addressed with the lens of someone who is new to your project.
272
272
Give potential contributors everything
273
-
they need to start working, reducing questions during the sprint. For a table of
273
+
they need to start working, which helps reduce adminstrative questions during the sprint. For a table of
274
274
10-20 people sprinting for pyOpenSci, this means the sprint leader will have less
275
275
questions to answer during the sprint event.
276
276
@@ -289,11 +289,11 @@ of your team could tackle the issue. This tip came from
### Collect issues in a single place - the help-wanted board
292
+
### Collect issues in a single place—the help-wanted board
293
293
294
294
<figure>
295
295
<imgsrc="{{ site.baseurl }}/images/blog/2024/june/pyopensci-sprint-project-board.png"alt="A graphic that shows the pyOpenSci GitHub project board. The graphic shows two columns of the project board. The first is Python Packaging and it has 7 issues in that column. The second column says Beginner-friendly / non technical. The point of this graphic is just to show a user that a project board is a nice way to organize issues that contributors might want to challenge during a sprint. At the bottom there is text that says includes a beginner-friendly column and should have easy-to-understand issue titles."style="width: 80%;" />
296
-
<figcaption> Project boards help you organize your sprintable tasks into categories that might help a contributor find something that interests them. Here we have a beginner-friendly column for beginners. but we also include columns that are topical such as Python programming, ci / devops and Sphinx. Also notice that the issues are generally clearly titled.</figcaption>
296
+
<figcaption> Project boards help you organize your sprintable tasks into categories that might help a contributor find something that interests them. Here we have a beginner-friendly column for beginners, but we also include columns that are topical such as Python programming, CI / DevOps and Sphinx. Also notice that the issues are generally clearly titled.</figcaption>
297
297
</figure>
298
298
299
299
Curate a `help-wanted` board that contains all the issues that could be completed
@@ -324,14 +324,14 @@ repository, which is why we set up the GitHub action.
324
324
{: .notice}
325
325
326
326
327
-
### Make it truly beginnerfriendly
327
+
### Make it truly beginner-friendly
328
328
329
329
To support beginners contributing to open source, consider having one or two helpers
330
330
(depending on the size of your sprint) who can assist with:
331
331
332
332
1. Understanding the issues
333
333
2. Using Git/GitHub
334
-
3. Directing them to beginner-friendly items
334
+
3. Directing novice sprinters to beginner-friendly items
335
335
336
336
In all of our sprints to date, we have had a mixture of people who:
337
337
@@ -347,12 +347,12 @@ contributions.
347
347
348
348
## Wrap up
349
349
350
-
Well-lead sprints offer both new and seasoned contributors an opportunity to
351
-
contribute to a project while also learning new skills, connecting with new people and learning about new projects. If you plan to support new
352
-
contributors in your sprint, then
350
+
Well-led sprints offer both new and seasoned contributors an opportunity to
351
+
contribute to a project, while also learning new skills, connecting with new people and learning about new projects. If you plan to support new
352
+
contributors in your sprint,
353
353
then it's ideal to do some legwork before the sprint begins to ensure sprint
354
-
attendees feel supported and have the help that they need, when they get stuck.
354
+
attendees feel supported and have the help that they need when they get stuck.
355
355
356
-
pyOpenSci is looking forward to our next sprint - to be held at the SciPy 2024 meeting in Tacoma, Washington. Last year we had 3 people make their first contributions to open source in our SciPy 2023 sprint. I'm hoping that this year is even better!
356
+
pyOpenSci is looking forward to our next sprint—to be held at the [SciPy 2024 meeting](https://www.scipy2024.scipy.org/) in Tacoma, Washington. Last year we had three people make their first contributions to open source in our SciPy 2023 sprint. I'm hoping that this year is even better!
0 commit comments