Skip to content

Commit

Permalink
feat(blog): new blog post on packaging and peer review
Browse files Browse the repository at this point in the history
  • Loading branch information
lwasser authored Aug 30, 2024
2 parents b6752f4 + 92a46dc commit 372e285
Show file tree
Hide file tree
Showing 50 changed files with 495 additions and 23 deletions.
2 changes: 2 additions & 0 deletions _includes/pyos-blockquote.html
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,10 @@
class="highlight-quote {% if include.class %}{{ include.class }}{% endif %}"
>
<p class="quote">{{ include.quote }}</p>
{% if include.author or include.event %}
<footer>
{% if include.author %}<strong>~{{ include.author }}{% endif %}</strong>{%
if include.event %}, <em>{{ include.event }}</em>{% endif %}
</footer>
{% endif %}
</blockquote>
2 changes: 1 addition & 1 deletion _posts/2019-10-26-pyos-min-mistakes-theme.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ permalink: docs/pyos-website/
header:
overlay_filter: 0.6
overlay_color: "#333"
last_modified: 2024-08-23
last_modified: 2024-08-28
toc: true
categories:
- docs
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ categories:
- peer-review
toc: false
comments: true
last_modified: 2023-04-18
---

<div class="notice" markdown="1">
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ categories:
- peer-review
toc: false
comments: true
last_modified: 2023-04-18
---

<div class="notice" markdown="1">
Expand Down
3 changes: 2 additions & 1 deletion _posts/2022-11-21-what-makes-a-python-package-healthy.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ categories:
- peer-review
toc: false
comments: true
last_modified: 2024-08-26
---

<div class="notice" markdown="1">
Expand Down Expand Up @@ -72,7 +73,7 @@ ecosystem. These packages tend to have smaller user bases, and smaller maintaine
teams (or often are maintained by one volunteer person).

<figure>
<a href="/images/python-packages/python-ecosystem-jake-vanderploss-pycon-2017.png"><img src="/images/python-packages/python-ecosystem-jake-vanderploss-pycon-2017.png" alt="Image used by Jake Vanderploss in the 2017 pycon conference that shows
<a href="/images/python-packaging/python-ecosystem-jake-vanderploss-pycon-2017.png"><img src="/images/python-packaging/python-ecosystem-jake-vanderploss-pycon-2017.png" alt="Image used by Jake Vanderploss in the 2017 pycon conference that shows
the ecosystem of scientific python packages starting with foundational packages
and moving out to the wealth of smaller, domain specific packages."></a>
<figcaption>Image used by Jake Vanderploss in the 2017 pycon conference that shows
Expand Down
9 changes: 5 additions & 4 deletions _posts/2023-03-22-demystifying-python-packaging.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ categories:
- python-packaging
toc: false
comments: true
last_modified: 2024-08-26
---

## A guide to make Python packaging easier for scientists
Expand Down Expand Up @@ -58,8 +59,8 @@ At the same time I noticed that many did not want to talk about
Python packaging. And I wondered, why?

<figure>
<a href="/images/python-packages/lion-meme-pyopensci.jpeg">
<img src="/images/python-packages/lion-meme-pyopensci.jpeg" style="max-width:100%" alt="A meme showing a mountain lion with it's little paw up like an italian mobster. the meme text says - so you want to talk about python packaging..">
<a href="/images/python-packaging/lion-meme-pyopensci.jpeg">
<img src="/images/python-packaging/lion-meme-pyopensci.jpeg" style="max-width:100%" alt="A meme showing a mountain lion with it's little paw up like an italian mobster. the meme text says - so you want to talk about python packaging..">
</a>
<figcaption>People didn't want to talk about Python packaging. It was such a painful, sore topic.
</figcaption>
Expand Down Expand Up @@ -143,8 +144,8 @@ In general, users want to use the simplest approach to publish their packages on
Remember - early wins go a long way.

<figure>
<a href="/images/python-packages/dont-talk-about-peps-pyopensci.jpeg">
<img src="/images/python-packages/dont-talk-about-peps-pyopensci.jpeg" style="max-width:100%" alt="A meme from the movie flight flub showing brad pitt with his arms crossed in a black tshirt. The text says - the first rul of peps is do not talk about peps.">
<a href="/images/python-packaging/dont-talk-about-peps-pyopensci.jpeg">
<img src="/images/python-packaging/dont-talk-about-peps-pyopensci.jpeg" style="max-width:100%" alt="A meme from the movie flight flub showing brad pitt with his arms crossed in a black tshirt. The text says - the first rul of peps is do not talk about peps.">
</a>
<figcaption>At one point, I was trying to link to Python standards - known as PEPS (Python Enhancement Protocols) given everyone was sharing the various PEPs that tools follow. I was then told that we should avoid linking to these pages as they weren't intended for public consumption. If that is the case then how does the public get current information about standards? While I understood the goal, My mind was a bit blown. This was one of many points of confusion that I had to sort through. :)
</figcaption>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ categories:
toc: false
classes: wide
comments: true
last_modified: 2023-06-15
---

# pyCon 2023 US -David Nicholson Lightning Talk on pyOpenSci Peer Review
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ categories:
classes: wide
toc: false
comments: true
last_modified: 2024-08-26
---

## How it all went down - PyCON US 2023, Salt Lake City, Utah
Expand Down Expand Up @@ -76,8 +77,8 @@ I spent a bit of time in that video talking about how we create our guides.
- Our process is normally several steps including an initial writing of content that is reviewed by experts. Followed by 2 rounds of open reviews of the content. The image below describes that process.

<figure>
<a href="/images/python-packages/pycon-packaging-review-process.png">
<img src="/images/python-packages/pycon-packaging-review-process.png" style="max-width:100%" alt="Graphic that has a large purple thick arrow. The title says Python Packaging Guide - Our Process. The sections in the arrow include Talk with core experts (write a section of the guide), semi-closed review (core experts review), Open Review 1 (ping tool developers and maintainers and welcome broad community feedback) and Open Review 2 (welcome broad community feedback).">
<a href="/images/python-packaging/pycon-packaging-review-process.png">
<img src="/images/python-packaging/pycon-packaging-review-process.png" style="max-width:100%" alt="Graphic that has a large purple thick arrow. The title says Python Packaging Guide - Our Process. The sections in the arrow include Talk with core experts (write a section of the guide), semi-closed review (core experts review), Open Review 1 (ping tool developers and maintainers and welcome broad community feedback) and Open Review 2 (welcome broad community feedback).">
</a>
<figcaption>Image from my talk that shows our packaging guide review process. Our packaging guide is community-driven. This means that every page of the guide has been reviewed by dozens of people with expertise in the packaging space. While this meant that it is taking extra time to create the guide, it also means the community supports it. We value community knowledge and input at pyOpenSci.
</figcaption>
Expand All @@ -91,8 +92,8 @@ packaging tools.
_Leave no stone unturned_ (my motto when doing most things).

<figure>
<a href="/images/python-packages/pyOS-package-guide-contributors.png">
<img src="/images/python-packages/pyOS-package-guide-contributors.png" style="max-width:100%" alt=".sdf">
<a href="/images/python-packaging/pyOS-package-guide-contributors.png">
<img src="/images/python-packaging/pyOS-package-guide-contributors.png" style="max-width:100%" alt=".sdf">
</a>
<figcaption>Image from my talk that shows our packaging guide review process. Our packaging guide is community-driven. This means that every page of the guide has been reviewed by dozens of people with expertise in the packaging space. While this meant that it is taking extra time to create the guide, it also means the community supports it. We value community knowledge and input at pyOpenSci.
</figcaption>
Expand Down
1 change: 1 addition & 0 deletions _posts/2023-07-18-pyopensci-scipy-2023.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ categories:
classes: wide
toc: false
comments: true
last_modified: 2023-07-25
---

## <i class="fa-solid fa-fish-fins"></i> Shark attack - pyOpenSci at SciPy
Expand Down
1 change: 1 addition & 0 deletions _posts/2023-09-11-community-manager-job-available.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ toc: true
comments: true
redirect_from:
- /blog/pyOpenSci-hiring-community-manager-spring-2023.html
last_modified: 2024-04-04
---

<div class="notice" markdown="1">
Expand Down
1 change: 1 addition & 0 deletions _posts/2023-10-18-rse-2023-pyopensci-bof.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ categories:
- community
toc: true
comments: true
last_modified: 2023-10-31
---

## Intro
Expand Down
1 change: 1 addition & 0 deletions _posts/2023-11-29-welcome-jesse-pyos-community-manager.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ categories:
- community
toc: true
comments: true
last_modified: 2023-11-29
---

## Chicago, cats, and community
Expand Down
1 change: 1 addition & 0 deletions _posts/2024-01-03-czi-funds-pyopensci-2024.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ categories:
- community
toc: true
comments: true
last_modified: 2023-12-29
---

## A bright 2024 is ahead for pyOpenSci
Expand Down
1 change: 1 addition & 0 deletions _posts/2024-03-01-pyos-newsletter-march-2024.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ categories:
classes: wide
toc: true
comments: true
last_modified: 2024-04-07
---

## <i class="fa-solid fa-rocket"></i> Welcome, AstroPy
Expand Down
1 change: 1 addition & 0 deletions _posts/2024-04-01-pyos-newsletter-april-2024.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ categories:
classes: wide
toc: true
comments: true
last_modified: 2024-04-17
---

## <i class="fa-solid fa-heart"></i> To 200 and beyond!
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ categories:
classes: wide
toc: true
comments: true
last_modified: 2024-04-16
---

## The three petals of pyOpenSci
Expand Down
1 change: 1 addition & 0 deletions _posts/2024-04-18-rdata-read-r-datasets.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ categories:
- datasets
- highlight
comments: true
last_modified: 2024-04-18
---

In the last years Python has solidified itself as the main language for data science and machine learning.
Expand Down
1 change: 1 addition & 0 deletions _posts/2024-04-29-pyos-newsletter-may-2024.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ categories:
classes: wide
toc: true
comments: true
last_modified: 2024-05-02
---

## <i class="fa-solid fa-seedling"></i> Spring is in the Air
Expand Down
5 changes: 3 additions & 2 deletions _posts/2024-05-14-pyos-guide-to-pyconus-2024.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ categories:
classes: wide
toc: true
comments: true
last_modified: 2024-08-26
---
## <i class="fa-solid fa-heart"></i> Connect with the pyOpenSci community at PyCon US 2024!
We know there are a million things to do and see while at [PyCon US 2024](https://us.pycon.org/2024/) in beautiful Pittsburgh this weekend, so we wanted to compile a list of every talk, keynote, summit, and panel where you can expect to meet some of the fantastic pyOpenSci community members as well as hear from some friends of pyOpenSci!
Expand Down Expand Up @@ -52,8 +53,8 @@ Diversity and inclusion is core to the pyOpenSci mission, and we can't wait for
*Hall C*\
**[Leah Wasser](https://github.com/lwasser)**
<figure>
<a href="/images/python-packages/lion-meme-pyopensci.jpeg">
<img src="/images/python-packages/lion-meme-pyopensci.jpeg" style="max-width:100%" alt="A puma leaning against a rock and flexing a front arm. Overlaid on the photo in meme text is the phrase 'so you want to talk about Python packaging.'">
<a href="/images/python-packaging/lion-meme-pyopensci.jpeg">
<img src="/images/python-packaging/lion-meme-pyopensci.jpeg" style="max-width:100%" alt="A puma leaning against a rock and flexing a front arm. Overlaid on the photo in meme text is the phrase 'so you want to talk about Python packaging.'">
</a>
</figure>
We couldn't talk about PyCon US without talking about our Executive Director and Founder, Leah Wasser, who will be talking all things Python packaging! Python packaging can be a scary and confusing endeavor. The ecosystem can be thorny and filled with many decisions around which tool or approach to use. You’re also likely to get pricked by an approach or tutorial that doesn't work as expected. However, the packaging journey doesn’t have to be prickly - particularly for pure Python packages. By building community consensus around user goals and moderating healthy discussion, pyOpenSci is paving a smooth, thorn-free path for successful packaging.
Expand Down
1 change: 1 addition & 0 deletions _posts/2024-05-23-pyos-call-for-editors.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ categories:
classes: wide
toc: true
comments: true
last_modified: 2024-06-10
---
## Join the pyOpenSci Editorial Board
### We're currently in need of editors with domain expertise in climatology and/or energy, and also accepting applications from all scientific domains
Expand Down
1 change: 1 addition & 0 deletions _posts/2024-05-24-oss-fall-festival-save-the-date-2024.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ categories:
classes: wide
toc: true
comments: true
last_modified: 2024-08-12
---
## You're invited: pyOpenSci's Open Science Fall Festival 2024
Happening ~~September 28--29th, 2024,~~ October 28th through November 1st, 2024, the pyOpenSci Open Science Fall Festival will be held entirely online, and be a fantastic opportunity to bring together members of the Python community that create open source, open science tools with the members of the Python community who use these tools. In building this festival, our focus is on a grassroots, community-led event with some big unconference vibes.
Expand Down
1 change: 1 addition & 0 deletions _posts/2024-05-28-pyos-newsletter-june-2024.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ categories:
classes: wide
toc: true
comments: true
last_modified: 2024-07-04
---
## <i class="fa-regular fa-comments"></i> PyCon was incredible!
We feel so incredibly fortunate to have connected with so many of you at PyCon US! While we're still recovering from a week of summits, talks, and sprints, we wanted to share this sentiment from our Executive Director and Founder, [Leah Wasser](https://github.com/lwasser), which she shared on [her Fosstodon account](https://fosstodon.org/@leahawasser):
Expand Down
7 changes: 1 addition & 6 deletions _posts/2024-05-30-pyos-pyconus-2024-recap.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,14 +13,9 @@ categories:
classes: wide
toc: true
comments: true
last_modified: 2024-08-02
---

<!-- TODOs:
* embed video when live
* add graphics from social that jesse sent
* fix captions
* add stravalib note at the end of my talk section -->

<div class="notice" markdown = "1">
## TL;DR

Expand Down
1 change: 1 addition & 0 deletions _posts/2024-06-03-sleplet-slepian-wavelets.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ categories:
- signal-processing
- wavelets
comments: true
last_modified: 2024-06-10
---

[SLEPLET](https://github.com/astro-informatics/sleplet) is a Python package for
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ categories:
classes: wide
toc: true
comments: true
last_modified: 2024-07-29
---

## <i class="fa-solid fa-heart"></i> Python packaging and community: my first talk at PyCon US 2024
Expand Down
1 change: 1 addition & 0 deletions _posts/2024-06-06-get-involved-with-pyos.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ categories:
classes: wide
toc: true
comments: true
last_modified: 2024-06-10
---
## <i class="fa-regular fa-heart"></i> The pyOpenSci mission
Founded in 2018 by our Executive Director, [Leah Wasser](https://github.com/lwasser), pyOpenSci builds diverse community that supports free and open Python tools for processing scientific data. We also build technical skills needed to contribute to open source and that support open science. While a diverse, inclusive community is at our core, radiating out from it are the three petals–how we accomplish our community goals–of pyOpenSci. These are:
Expand Down
1 change: 1 addition & 0 deletions _posts/2024-06-20-pyos-guide-to-scipy.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ categories:
classes: wide
toc: true
comments: true
last_modified: 2024-07-23
---
## <i class="fa-regular fa-handshake"></i> See you at SciPy!

Expand Down
1 change: 1 addition & 0 deletions _posts/2024-07-10-automata.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ categories:
- pyos-accepted
classes: wide
comments: true
last_modified: 2024-07-10
---


Expand Down
1 change: 1 addition & 0 deletions _posts/2024-07-31-pyconus-pyopensci-sprints.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ categories:
classes: wide
toc: true
comments: true
last_modified: 2024-08-01
---

## pyOpenSci's approach to beginner-friendly sprints
Expand Down
1 change: 1 addition & 0 deletions _posts/2024-08-02-community-news-august-2024.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ categories:
classes: wide
toc: true
comments: true
last_modified: 2024-08-15
---


Expand Down
1 change: 1 addition & 0 deletions _posts/2024-08-02-pyopensci-at-scipy-2024.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ categories:
classes: wide
toc: true
comments: true
last_modified: 2024-08-15
---


Expand Down
Loading

0 comments on commit 372e285

Please sign in to comment.