Skip to content

Commit cb0e51b

Browse files
lwasserkierisi
andcommitted
Fix: Edits from @kierSi
Co-authored-by: Jesse Mostipak <[email protected]>
1 parent e9456d1 commit cb0e51b

File tree

1 file changed

+30
-30
lines changed

1 file changed

+30
-30
lines changed

_posts/2024-06-20-pyconus-pyopensci-sprints.md

Lines changed: 30 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,7 @@ These barriers include:
104104
* Time to contribute.
105105
* Skills to contribute.
106106
* 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.
108108
to participate.
109109

110110
And last but not least:
@@ -122,8 +122,8 @@ including:
122122
* Learning and growing skills that may not be accessible in your day job.
123123
* Connecting with other developers, data scientists, and scientists in the community.
124124
* 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.
127127

128128
Or, maybe you're like me—an Executive Director of a community organization. Coding and
129129
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!
139139

140140
So how do we align the challenges that contributors face with the potential opportunities?
141141

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
143143
in having the time and bandwidth to participate, they can be great for many.
144144

145145
But a sprint will only be a good experience if the contributor's needs and goals are also considered. Contributors need to gain something
146146
from contributing, and this requires:
147147

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.
150150

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
153153
a project! As such we can't expect all open source packages to be able to
154154
support beginner contributions in a comprehensive way.
155155

@@ -163,23 +163,23 @@ learner motivations. For me personally, contributing to Open Source met two of m
163163
and interests:
164164

165165
* **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!
167167
* **Student-directed learning:** I love to learn on my own time, following my own
168168
processes that work for me. Open Source allows me to do just that (and without the
169169
pressures of a specific deadline in most cases).
170170

171171
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 topicespecially as it relates to empowering people who are underrepresented in a space.
173173

174174
More on that next...
175175

176176
### The power of project-based learning
177177

178178
[Project-based learning](https://www.wpi.edu/project-based-learning/why-pbl) is
179179
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
181181
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)
183183
that I designed and ran when I was in academia.
184184

185185

@@ -193,7 +193,7 @@ outcome.
193193
It's similar to how you can immediately engage a diverse audience in GIS (spatial data) with Google
194194
Earth by asking them to zoom into the area where they live (place-based learning).
195195

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
197197
because I learn in a very applied way.
198198

199199
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
202202
> The learning motivation comes from a meaningful outcome that a student wants or cares
203203
about.
204204

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.
207207

208208
### The power of student-directed learning
209209

@@ -212,7 +212,7 @@ taught people the same way: in a classroom, using the same books and approaches.
212212
However, alternatives to this model allow learners to adapt their environment to their personal and learning goal needs.
213213
[Student-directed learning](https://scholar.google.com/scholar?q=student-directed+learning&hl=en&as_sdt=0&as_vis=1&oi=scholart)
214214
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.
216216

217217
Some learners benefit from hands-on demos, whether in a classroom or at the sprint
218218
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
228228
short tutorial/guidebook for making their first contribution using the GitHub
229229
interface.
230230

231-
### Collaborative git and GitHub lessons
231+
### Collaborative Git and GitHub lessons
232232

233-
This past year, I was awarded the BSSw fellowship 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 skillsthe 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!).
235235

236-
## The Anatomy of a pyOpenSci Sprint
236+
## The anatomy of a pyOpenSci sprint
237237

238238
Based on my understanding of the learning motivations and challenges that new
239239
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
270270
an issue is critical. Be sure to include the specific details of the issue
271271
to be addressed with the lens of someone who is new to your project.
272272
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
274274
10-20 people sprinting for pyOpenSci, this means the sprint leader will have less
275275
questions to answer during the sprint event.
276276

@@ -289,11 +289,11 @@ of your team could tackle the issue. This tip came from
289289
with contributors through her work on the
290290
[Contributor Experience Project](https://contributor-experience.org/).
291291

292-
### Collect issues in a single place - the help-wanted board
292+
### Collect issues in a single placethe help-wanted board
293293

294294
<figure>
295295
<img src="{{ 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>
297297
</figure>
298298

299299
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.
324324
{: .notice}
325325

326326

327-
### Make it truly beginner friendly
327+
### Make it truly beginner-friendly
328328

329329
To support beginners contributing to open source, consider having one or two helpers
330330
(depending on the size of your sprint) who can assist with:
331331

332332
1. Understanding the issues
333333
2. Using Git/GitHub
334-
3. Directing them to beginner-friendly items
334+
3. Directing novice sprinters to beginner-friendly items
335335

336336
In all of our sprints to date, we have had a mixture of people who:
337337

@@ -347,12 +347,12 @@ contributions.
347347

348348
## Wrap up
349349

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,
353353
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.
355355

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 sprintto 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!
357357

358358
Come join us if you are there!

0 commit comments

Comments
 (0)