Skip to content

Commit 6f9e80a

Browse files
committed
Add: new blog - scipy 24
1 parent 0820f38 commit 6f9e80a

25 files changed

+402
-41
lines changed

_posts/2024-05-30-pyos-pyconus-2024-recap.md

Lines changed: 9 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -21,15 +21,14 @@ comments: true
2121
* fix captions
2222
* add stravalib note at the end of my talk section -->
2323

24-
2524
<div class="notice" markdown = "1">
2625
## TL;DR
2726

2827
* pyOpenSci had a strong presence at [PyCon US](https://us.pycon.org/2024/) this year. I hope this continues for years to come! We held an open space, helped run the [Maintainers Summit](https://us.pycon.org/2024/events/maintainers-summit/) (lead by [Inessa Pawson](https://github.com/InessaPawson) for 5 years and counting), gave [a talk on Python packaging](https://us.pycon.org/2024/schedule/presentation/34/) and ran a 1 day sprint where over 16 people contributed to our efforts.
2928
* pyOpenSci’s theme this year for PyConUS was people first: people first when trying to make technical concepts easier to understand, people first when trying to write good tutorials or documentation and people first when you are trying to solve the world’s hardest problems.
3029
* Giving a talk on packaging at pyConUS triggered every ounce of the imposter in me. But in the end it was a rewarding experience. Having friends in the audience made a world of difference. It was calming to focus on people who I know support both me and this vibrant organization. Friends really should never let friends…package…or use Python…or do anything technical…alone.
31-
</div>
3230

31+
</div>
3332

3433
## Another year, another incredible PyCon
3534

@@ -42,7 +41,6 @@ PyCon US, run by the [Python Software
4241
Foundation,](https://www.python.org/psf-landing/) is one of the biggest Python meetings in the world, with a record 2,700 registrations this year.
4342
{: .notice }
4443

45-
4644
I also knew that I'd get to see a bunch of the friends who I met last year. I was returning to
4745
this inclusive community, filled with Pythonistas like me
4846
who care, who want to learn, and most importantly who want to help each other.
@@ -73,27 +71,30 @@ projects and organizations and our sprints were awesome with many new contributi
7371
My takeaway: if you are considering going to PyCon but are worried about not knowing
7472
people YOU SHOULD STILL GO! You can feel the true spirit of open source (and open science) at PyCon US. No judgement. All "levels" of Pythonistas welcome.
7573

76-
7774
## My first main track PyCon US talk: Friends don't let friends package alone
7875

7976
This year, I gave my first main track talk at PyCon, titled “Friends Don’t Let
8077
Friends Package Alone.” Getting a main track slot means presenting on a big
8178
stage to a huge room of people! It was real - headset mic, incredible
8279
tech support, and even an “escort” from the speaker room to the main stage. Wow!
8380

81+
You can check it out on youtube below:
82+
83+
{% include video id="mJPoj9Ex9fk" provider="youtube" %}
84+
8485
Speaking of friends, it was my friends who got me through this talk. I saw them sitting in
8586
the front rows, smiling and supporting me. They both empowered me and gave me calm.
8687

8788
As someone who often battles imposter syndrome, giving a talk on the "big" stage of a tech meeting
8889
was unforgettable.
8990

90-
9191
<figure>
9292
<img src="{{ site.baseurl }}/images/blog/2024/may/leah-talking-pyconus-2024.jpg" alt="Image of a woman on a big stage wearing a red tank top talking. On the side is a slide that says pyOpenSci - Save the Date. Open science fall festival september 28-29 2024" style="width: 70%;" />
9393
<figcaption><i class="fa-solid fa-heart-pulse"></i> Me talking on the stage! I was so nervous before but once I got up there, everything calmed in my mind. <i class="fa-solid fa-heart-pulse"></i>.</figcaption>
9494
</figure>
9595

9696
### A talk about making Python packaging more beginner friendly
97+
9798
My talk focused on how pyOpenSci helps beginners by breaking down
9899
complex packaging concepts into simple, digestible pieces. I leaned into decades of
99100
experience and study of teaching data science to various audiences, from big-ten university students
@@ -110,32 +111,17 @@ fundamental concepts, and
110111
* avoid “Too Many Options and Opinions” (TMO) to keep things simple
111112
for beginners.
112113

113-
114-
115114
<figure>
116115
<img src="{{ site.baseurl }}/images/blog/2024/may/pyopensci-too-many-python-packaging-options-pycon-talk-2024.png
117116
" alt="A cute image of a black flat coated retriever laying on the floor with a purple ice pack on it's head looking right at you." />
118117
<figcaption>Whether it's too many options or too many opinions, TMO will push beginner users away. Too many options create cognitive load that prevent users from having successful experiences.</figcaption>
119118
</figure>
120119

121-
122120
<!-- [I break this all down in more detail here if you want to read more.](#addlink) -->
123121

124122
Giving a talk at PyConUS experience reinforced my belief in the power of community to tackle complex
125123
problems and support each other in our scientific journeys.
126124

127-
128-
129-
<!--
130-
Or you can check out the talk itself on youtube below:
131-
132-
TODO: embed video - they are slowly being posted - 145 are in draft state....
133-
134-
2023 talk --
135-
https://www.youtube.com/watch?v=Qxy7bxW72iA
136-
-->
137-
138-
139125
## <i class="fa-solid fa-rocket"></i> The PyCon US maintainers Summit <i class="fa-solid fa-rocket"></i>
140126

141127
This year, I had the honor of helping [Inessa Pawson](https://github.com/InessaPawson) and [Kara Sowles](https://github.com/karasowles) organize the
@@ -160,7 +146,6 @@ quickly and a waitlist, the event was a success. Next year (if we are invited ba
160146

161147
{% include video id="L-Ok_89QJOM" provider="youtube" %}
162148

163-
164149
Also if you were wondering, yes that Monstera Deliciosa (plant) in the background is real! AND YES it is ginormous! <i class="fa-solid fa-leaf"></i>
165150

166151
## <i class="fa-solid fa-users-gear"></i> Our second pyOpenSci sprint <i class="fa-solid fa-users-gear"></i>
@@ -173,11 +158,9 @@ This year we had a tremendous turnout of over 20 people from several countries f
173158
<figcaption>The pyConUS sprint sign-up board had lots of projects. Because the rooms are large, projects tend to share spaces. We ended up in the packaging room which was great as it allowed us to do some more difficult work around Python packages with C extensions!</figcaption>
174159
</figure>
175160

176-
177-
178161
If you haven’t been to a sprint before, it’s an experience that every open source enthusiast should have. Sprints are where a bunch of people come together to work on a project. If you are running sprints that support software development in a professional environment (i.e. at a company) this might mean a team of people working together on releasing a new software feature. But for the open source community, sprints can also mean volunteers coming to a space to help maintainers work on various parts of a project that they care about - like pyOpenSci!
179162

180-
pyOpenSci supports other people's software through it's [open community-lead peer review process ](https://www.pyopensci.org/about-peer-review/index.html) and it's online, free [packaging resources](https://www.pyopensci.org/python-package-guide/). But it also has it's own software too. We have tools that help us keep track of our review process and volunteer contributions so we can acknowledge everyone for their effort.
163+
pyOpenSci supports other people's software through it's [open community-lead peer review process](https://www.pyopensci.org/about-peer-review/index.html) and it's online, free [packaging resources](https://www.pyopensci.org/python-package-guide/). But it also has it's own software too. We have tools that help us keep track of our review process and volunteer contributions so we can acknowledge everyone for their effort.
181164

182165
Acknowledging contributions is so so so (did I mention SO?) important. And we value them so much.
183166

@@ -225,8 +208,8 @@ workflows that allow allowing scientists to focus on their research
225208
rather than tools. We plan to tackle some of these and other topics during our Fall festival on September 28-29,
226209
2024 so save the date and come ready to learn and share!
227210

228-
229211
## <i class="fa-solid fa-box-open"></i> Packaging summit
212+
230213
Last but not least, pyOpenSci had a strong presence at the PyConUS packaging summit this year. The summit was organization by [Pradyun Gedam](https://github.com/pradyunsg), [Jannis Leidel](https://github.com/jezdez), [CAM Gerlach](https://github.com/CAM-Gerlach), [Filipe Laínes](https://github.com/FFY00). As I have mentioned several times, packaging is one of the more thorny topics in our Python ecosystem. However, this year, things felt different compared to last.
231214

232215
For one, there were a lot more people in the room, and people with different perspectives. For starters, last year I was 1 of 3? female-identifying people in the room - this year there were people from many backgrounds and identities in the room! Last year also felt more technical whereas this year was a perfect mix of discussing technical topics combined with a strong theme of considering user experience in both installing Python and creating packages. PLUS - documentation - yes PLEASE!
@@ -237,7 +220,7 @@ I'm hopeful.
237220

238221
From my perspective, the biggest challenges in our ecosystem revolve around:
239222

240-
* too much focus on tools and not enough focus on user experience and documentation, and
223+
* too much focus on tools and not enough focus on user experience and documentation, and
241224
* too many options and opinions that prevent users from have early success.
242225

243226
There is a path forward. And people who are working on tools in the ecosystem really do care -- a lot. So please thank them - thank the maintainers and people who work on the tools that you use - or might use in the future. It's all volunteer time.

_posts/2024-06-05-friends-dont-let-friends-package-alone-pyconus-24.md

Lines changed: 7 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,10 @@ This year I gave my first talk in the [PyCon US](https://us.pycon.org/2024/) mai
2525

2626
The irony of these three different perspectives is that the challenges that users face in each category are similar! Below I explore my experiences pulling together the talk.
2727

28+
You can also watch the talk here:
29+
30+
{% include video id="mJPoj9Ex9fk" provider="youtube" %}
31+
2832
### My early experiences with Python packaging
2933

3034
I started thinking about Python packaging in 2018 during our [early pyOpenSci
@@ -41,14 +45,11 @@ infrastructure that other package maintainers I trusted used—mainly GeoPandas.
4145

4246
*I am a spatial data nerd at heart.*
4347

44-
4548
<figure>
4649
<img src="{{ site.baseurl }}/images/blog/2024/june/pycon-python-packaging-confusion.png" alt="Image that says have you ever felt confused about python packaging. Below is the pyopensci flower logo. And the graphic shows a bunch of different cartoon like hands being raised." style="width: 90%;" />
4750
<figcaption> Every time I ask this question, a majority of people in the room raise their hand.</figcaption>
4851
</figure>
4952

50-
51-
5253
But as I thought about creating pyOpenSci's open peer review process, I knew
5354
scientists would need a process that:
5455

@@ -92,6 +93,7 @@ So if you think about that "opportunity to make a wrong decision", imagine what
9293
</figure>
9394

9495
### The evolution of the pyOpenSci Python packaging guide
96+
9597
Years later, what started out as a generic Python development guide, was
9698
transformed into what’s now the [pyOpenSci Python package guide](https://www.pyopensci.org/python-package-guide/).
9799

@@ -123,7 +125,6 @@ still leading users down a streamlined path.
123125
<figcaption><i class="fa-solid fa-heart-pulse"></i> The generalized scientific Python package development process. <i class="fa-solid fa-heart-pulse"></i>.</figcaption>
124126
</figure>
125127

126-
127128
## Getting accepted to talk about packaging... <i class="fa-solid fa-ghost"></i>
128129

129130
I was thrilled and terrified to be accepted to give a talk at [PyCon US](https://us.pycon.org/2024/), in Pittsburgh, Pennsylvania, on the process of creating the pyOpenSci Python packaging guidebook . My talk was called:
@@ -192,7 +193,7 @@ Sometimes, that someone is me — before I can teach the topic to others!
192193

193194
## So what about packaging with friends?
194195

195-
The essence of my Python packaging talk was the work that I have lead alongside the pyOpenSci community to demystify and help _people_ navigate the complex Python packaging ecosystem.
196+
The essence of my Python packaging talk was the work that I have lead alongside the pyOpenSci community to demystify and help *people* navigate the complex Python packaging ecosystem.
196197

197198
This work was really about people helping people tackle challenging things.
198199

@@ -211,8 +212,7 @@ Python is known for its incredible community, so it only made sense to leverage
211212

212213
The talk can be broken down into 4 takeaways:
213214

214-
215-
### People can help (_surprise_!)
215+
### People can help (*surprise*!)
216216

217217
When tackling some of the most thorny technical Python problems, people can help. This might mean:
218218

@@ -259,26 +259,21 @@ When teaching beginners, break things down to their fundamental concepts. In the
259259
<figcaption><i class="fa-solid fa-heart-pulse"></i> By breaking down packaging in to it's most basic steps you are making the concepts immediately more digestable to users. Once they understand the basics you can slowly layer in additional complexity. <i class="fa-solid fa-heart-pulse"></i>.</figcaption>
260260
</figure>
261261

262-
263262
While some may think that this approach is over simplified, it’s not. The idea here is that you begin with digestible information that empowers a learner. You help them understand that they can do this! And then, and only then, you add more complexity when they are ready to absorb it.
264263

265264
This also opens the door wide to early wins.
266265

267-
268266
### Just say no to TMO
269267

270268
Avoid TMO—Too Many Options or Too Many Opinions at all costs when teaching beginners. Options are great, but when someone is new to a topic, it’s best to give them a straightforward path to success.
271269

272270
Early on in creating our packaging guide, we found contributors, often quite expert in the packaging ecosystem, arguing about the best tools and best practices. Since we invited many people with different levels of experience to review our content, these arguments pushed some people away and created an unhealthy environment. Moderating these conversations to focus on the users and their needs, rather than debating tools, was critical. This approach helped create a truly beginner-friendly guide and fostered a review environment that was safe and inclusive, where both beginners and experts could contribute.
273271

274-
275272
<figure>
276273
<img src="{{ site.baseurl }}/images/blog/2024/june/pyopensci-python-packaging-tmo.png" alt="Dark purple background image that says no TMO. Below is a yellow lab retriever with a purple ice bag on it's head looking sad and directly at you." style="width: 100%;" />
277274
<figcaption><i class="fa-solid fa-heart-pulse"></i> When it comes to packaging, too many options and too many opinions get in the way of a positive user experience. We need to work towards breaking things down and providing opinionated paths for those who want and need them. <i class="fa-solid fa-heart-pulse"></i>.</figcaption>
278275
</figure>
279276

280-
281-
282277
### Friends don’t let friends package alone
283278

284279
When I finished my talk, I felt this sense of relief but also I felt love, support and deep passion for this topic and the community. It’s more than just packaging. It is about empowering people with skills that will help them tackle the biggest scientific challenges that we face as humans. Science is about data. And to process data we need tools - open tools that are accessible for scientists to learn and use. It’s about carving out space for scientists to build and use these tools. And also to make space for people who may feel like outsiders, because of who they are, to participate.

0 commit comments

Comments
 (0)