Skip to content

Commit baae969

Browse files
kierisikierisi
authored
Merge branch 'main' into fall-festival-event
2 parents 99a0034 + efec87e commit baae969

29 files changed

+779
-262
lines changed

‎_includes/feature_row_pyos

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
{% for f in feature_row %}
99
<div class="cards highlight">
1010
{% if f.image_path %}
11-
<div>
11+
<div class="cards__image">
1212
<img src="{{ f.image_path | relative_url }}"
1313
alt="{% if f.alt %}{{ f.alt }}{% endif %}">
1414
{% if f.image_caption %}

‎_includes/masthead.html

Lines changed: 53 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -1,59 +1,61 @@
11
{% capture logo_path %}{{ site.logo }}{% endcapture %}
22

33
<div class="masthead">
4-
<div class="masthead__inner-wrap">
5-
<div class="masthead__menu">
6-
<nav id="site-nav" class="nav__topbar" aria-label="Top Bar">
7-
<!-- More accessible as a screen reader will group the title and image in the same link -->
8-
{% unless logo_path == empty %}
9-
<a class="site-logo" href="{{ '/' | relative_url }}">
10-
<img src="{{ logo_path | relative_url }}" alt="Welcome to the pyOpenSci website. The pyOpenSci logo is a purple flower opening over the O (for open).">
11-
</a>
12-
{% endunless %}
4+
<nav id="site-nav" class="masthead__menu" aria-label="Top Bar">
5+
<!-- More accessible as a screen reader will group the title and image in the same link -->
6+
{% unless logo_path == empty %}
7+
<a class="site-logo" href="{{ '/' | relative_url }}">
8+
<img src="{{ logo_path | relative_url }}" alt="Welcome to the pyOpenSci website. The pyOpenSci logo is a purple flower opening over the O (for open).">
9+
</a>
10+
{% endunless %}
1311

14-
<ul class="nav__links">
15-
{%- for alink in site.data.navigation.main -%}
16-
<!-- If there are sub links drop down nav to display -->
17-
{% if alink.sub-nav %}
18-
<li class="dropdown">
19-
<button class="dropbtn" tabindex="0" aria-expanded="false">{{ alink.title }} <i class="fas fa-caret-down"></i>
20-
</button>
21-
<ul class="dropdown-content">
22-
{% for subnav in alink.sub-nav %}
23-
<li>
24-
<a href="{{ subnav.url | relative_url }}" class="masthead__menu-item hover-underline">{{ subnav.title }}
25-
{% if subnav.icon %} <i class="{{ subnav.icon }}"></i> {% endif %}
26-
</a>
27-
</li>
28-
{% endfor %}
29-
</ul>
30-
</li>
31-
{% else %}
12+
<div class="spacer"></div>
13+
14+
<ul class="nav__links">
15+
{%- for alink in site.data.navigation.main -%}
16+
<!-- If there are sub links drop down nav to display -->
17+
{% if alink.sub-nav %}
18+
<li class="dropdown">
19+
<button class="dropbtn" tabindex="0" aria-expanded="false">
20+
{{ alink.title }} <i class="fas fa-caret-down"></i>
21+
</button>
22+
<ul class="dropdown-content">
23+
{% for subnav in alink.sub-nav %}
3224
<li>
33-
<a href="{{ alink.url | relative_url }}" class="hover-underline">{{ alink.title }}</a>
25+
<a
26+
href="{{ subnav.url | relative_url }}"
27+
class="masthead__menu-item hover-underline"
28+
>{{ subnav.title }}
29+
{% if subnav.icon %}
30+
<i class="{{ subnav.icon }}"></i>
31+
{% endif %}
32+
</a>
3433
</li>
35-
{% endif %}
36-
{% endfor %}
37-
<li>
38-
39-
</li>
40-
</ul>
41-
42-
{% if site.search == true %}
43-
<button class="search__toggle" type="button">
44-
<span class="visually-hidden">{{ site.data.ui-text[site.locale].search_label | default: "Toggle search" }}</span>
45-
<i class="fas fa-search"></i>
46-
</button>
47-
{% endif %}
34+
{% endfor %}
35+
</ul>
36+
</li>
37+
{% else %}
38+
<li>
39+
<a href="{{ alink.url | relative_url }}" class="hover-underline">
40+
{{ alink.title }}
41+
</a>
42+
</li>
43+
{% endif %}
44+
{% endfor %}
45+
</ul>
4846

47+
{% if site.search == true %}
48+
<button class="search__toggle" type="button">
49+
<span class="visually-hidden">{{ site.data.ui-text[site.locale].search_label | default: "Toggle search" }}</span>
50+
<i class="fas fa-search"></i>
51+
</button>
52+
{% endif %}
4953

50-
<ul class="hidden-links hidden"></ul>
51-
<!-- Burger button - span class for screen readers-->
52-
<button class="hamburger__btn-toggle" type="button" count="1" aria-expanded="false">
53-
<span class="visually-hidden">Toggle top navigation menu</span> <!--screen readers-->
54-
<div class="burger__icon"></div>
55-
</button>
56-
</nav>
57-
</div>
58-
</div>
59-
</div>
54+
<ul class="hidden-links hidden"></ul>
55+
<!-- Burger button - span class for screen readers-->
56+
<button class="hamburger__btn-toggle" type="button" count="1" aria-expanded="false">
57+
<span class="visually-hidden">Toggle top navigation menu</span> <!--screen readers-->
58+
<div class="burger__icon"></div>
59+
</button>
60+
</nav>
61+
</div>

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

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -112,8 +112,7 @@ fundamental concepts, and
112112
for beginners.
113113

114114
<figure>
115-
<img src="{{ site.baseurl }}/images/blog/2024/may/pyopensci-too-many-python-packaging-options-pycon-talk-2024.png
116-
" 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." />
115+
<img src="{{ site.baseurl }}/images/blog/2024/may/pyopensci-too-many-python-packaging-options-pycon-talk-2024.png" 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." />
117116
<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>
118117
</figure>
119118

‎_posts/2024-08-02-community-news-august-2024.md

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
---
2+
layout: single
3+
title: "pyOpenSci Community News: August 2024"
4+
excerpt: "Welcome to the first edition of pyOpenSci's Community News newsletter, where we summarize and share conversations, contributions, and news related to our diverse and vibrant community! Read on for insights into running pyOpenSci sprints, Python packaging guide Spanish translation efforts, and using Hatch to create and maintain Pythons."
5+
author: "Jesse Mostipak"
6+
permalink: /blog/pyos-community-news-aug-2024.html
7+
header:
8+
overlay_image: /images/headers/white-header.png
9+
overlay_filter: rgba(20, 13, 36, 0.8)
10+
categories:
11+
- blog-post
12+
- community
13+
classes: wide
14+
toc: true
15+
comments: true
16+
---
17+
18+
19+
## <i class="fa-regular fa-heart"></i> pyOpenSci community news
20+
21+
As the pyOpenSci community has continued to grow, we wanted to dedicate at least one newsletter issue a month to sharing conversations, contributions, and news related to our diverse and vibrant community! This month we’re celebrating everyone who’s participated in a pyOpenSci sprint, sharing the exciting news around the Spanish translation of our Python Packaging Guide, and elevating a discussion from GitHub around the use of Hatch for Python package creation.
22+
23+
## <i class="fa-solid fa-egg"></i> Hello, Hatch!
24+
25+
Education is one of the [three petals of pyOpenSci](https://www.pyopensci.org/blog/pyos-education-announcement.html), and to that end we strive to create resources that help learners navigate the Python packaging ecosystem with ease. This means that when we find our community members and scientists encountering consistent issues with trying to make their workflows more open and reproducible, or trying to build a Python package, we look for ways to lower (or ideally remove!) the barrier for learners. And this was exactly the scenario we were faced with in our beginner-friendly packaging tutorials. We decided that Hatch is a great user-friendly tool that scientists can use to package and share their code. However, in developing and teaching our [Get to know Hatch tutorial](https://www.pyopensci.org/python-package-guide/tutorials/get-to-know-hatch.html), we found scientists struggling to install a tool called [`pipx`](https://github.com/pypa/pipx) that can be used to install Hatch globally, rather than in a Python environment. This was causing a host of problems (in large part because `pipx` can be tricky to install on Windows machines!)
26+
27+
<figure>
28+
<img src="{{ site.baseurl }}/images/pyopensci-pillars-flower.png" alt="a circle and three petals representing the pillars of pyOpenSci. The circle at the center represents a diverse, inclusive community, and radiating out from it are the three petals–how pyOpenSci accomplishes its community goals. Those are: open peer review, community partnerships, and training and open educational resources." style="width: 70%;" />
29+
<figcaption><i class="fa-solid fa-heart-pulse"></i>The three petals of pyOpenSci<i class="fa-solid fa-heart-pulse"></i>.</figcaption>
30+
</figure>
31+
32+
We know that it can be challenging to wrap your head around packaging, but what it boils down to is that packaging is really just a process of making your code installable so that it can be reused in different places. And while we decided to use Hatch because it makes packaging life easier, it turns out that Hatch has its own nuanced pain points that we’re still filing down! And we want to share this, because we firmly believe that even someone who is brand new to packaging can get value out of our materials.
33+
34+
> ...packaging is really just a process of making your code installable so that it can be reused in different places.
35+
36+
If you’d like to dig into the details of our Hatch installation adventures, we recommend reading through the discussions in the associated issue and PR:
37+
38+
* [Fix: update hatch install instructions to use the hatch installers rather than pipx in our tutorial #301](https://github.com/pyOpenSci/python-package-guide/issues/301)
39+
* [All Hatch PRs: [Tuesday july 2 merge] Fix: update hatch install instructions](https://github.com/pyOpenSci/python-package-guide/pull/308)
40+
41+
And for those of you who are interested in the end result, after a robust and lively community discussion, we’ve updated our Get to know Hatch tutorial with the following changes:
42+
43+
1. Suggest users default to the Hatch installers rather than `pipx`.
44+
2. Suggest Linux users use `pipx` as the install there is simpler.
45+
46+
It’s important to us to elevate this conversation, because all of our materials are community–developed and go through extensive technical review not only before they’re published for the first time, but also for the entire lifetime of the content! We value openness and transparency, and because of the open discussions with community members, we’ve been able to make it even easier to get started with Python packaging!
47+
48+
## <i class="fa-solid fa-earth-americas"></i> Coming soon: a Spanish translation of the pyOpenSci Python Package Guide
49+
50+
This past May, during our [PyCon US sprints](https://www.pyopensci.org/blog/pyopensci-pyconus-2024-sprints.html), pyOpenSci community member [Felipe Moreno](https://github.com/flpm) submitted [an issue to our Python Package Guide GitHub repository](https://github.com/pyOpenSci/python-package-guide/issues/287), asking if we had considered translating the guide to Spanish. Felipe is an experienced security engineering manager with a strong background in Python software development, data science and user-centered design, who leads the Security Data Science team at [Bloomberg LP](https://www.bloomberg.com/company/). Felipe has worked with other projects, setting up infrastructure support through [Sphinx](https://www.sphinx-doc.org/en/master/) for this kind of work. We were, of course, immediately thrilled with the idea, and took Felipe up on the offer! From there, Felipe built a PR that created a [translation guide for contributors](https://github.com/pyOpenSci/python-package-guide/pull/304), along with another PR that [provides internationalization support](https://github.com/pyOpenSci/python-package-guide/pull/298).
51+
52+
Following Felipe’s initial efforts, several of our SciPy sprint attendees continued to work on translation of the pyOpenSci Python Packaging Guide, and you can see their progress in the [guide repository on GitHub](https://github.com/pyOpenSci/python-package-guide/issues?q=is%3Aopen+is%3Aissue+label%3Ascipy-24). This has resulted in 13 PRs to our packaging guide. Our next steps are to create an editorial team composed of members who are fluent in Spanish/native speakers. This team will be responsible for reviewing and merging these contributions. Stay tuned for updates on this incredible community-driven project!
53+
54+
> Following Felipe’s initial efforts, several of our SciPy sprint attendees continued to work on translation of the pyOpenSci Python Packaging Guide...resulting in 13 PRs to our packaging guide.
55+
56+
If you have questions about how to get involved with pyOpenSci, please reach out to [[email protected]]([email protected]) so that we can connect you with the right people!
57+
58+
## <i class="fa-solid fa-rainbow"></i> All the credit for our contributors
59+
60+
We have been absolutely floored by the community involvement with pyOpenSci over the last few months, and wanted to take a moment to recognize everyone who has been a part of our sprints at both [PyCon US](https://us.pycon.org/2024/) and [SciPy](https://www.scipy2024.scipy.org/)! In total we’ve had over 30 contributors submit 65 issues to six different pyOpenSci repos between the two events, which is incredible.
61+
62+
### Props to all of our PyCon contributors, including:
63+
Jesse Bobish, [Patrick Byers](https://github.com/pb-413), [Sarah Kaiser](http://github.com/crazy4pi314), [Ryan Keith](https://github.com/ryanskeith), [Jon Kiparsky](https://github.com/jonkiparsky), [Filipe Laíns](https://github.com/FFY00), [Cheng Lee](https://github.com/chenghlee), [Felipe Moreno](https://github.com/flpm), [Matthew Ngoy](https://github.com/Vaunty), [Jeremy Paige](https://github.com/ucodery), [Ken Seehart](https://github.com/kenseehart), [Steven Silvester](https://github.com/blink1073), [Megan Sosey](https://github.com/sosey), [Zack Weinberg](https://github.com/zackw), [Brianne Wilhelmi](https://github.com/BSuperbad), [Carol Willing](https://github.com/willingc), [Sneha Yadav](https://github.com/sn3hay), and [Bradon Zhang](https://github.com/BradonZhang).
64+
65+
> In total we’ve had over 30 contributors submit 65 issues to six different pyOpenSci repos between the two events, which is incredible.
66+
67+
### Shout out to all of our SciPy contributors, including:
68+
[Naty Clementi](https://github.com/ncclementi), [Geoff Cureton](https://github.com/gpcureton), [John Drake](https://github.com/John-Drake), [Han](https://github.com/ayhanxian), [Elise Hinman](https://github.com/ehinman), [hpodzorski-USGS](https://github.com/hpodzorski-USGS), [Sarah Kaiser](https://github.com/crazy4pi314), [kaiyamag](https://github.com/kaiyamag), [Felipe Moreno](https://github.com/flpm), [Roberto Pastor Muela](https://github.com/RobPasMue), [Olek](https://github.com/yardasol), [Santiago Soler](https://github.com/santisoler), and [Revathy Venugopal](https://github.com/Revathyvenugopal162).
69+
70+
## <i class="fa-regular fa-envelope"></i> Stay connected with pyOpenSci
71+
72+
There are so many ways to stay up-to-date with all things pyOpenSci, including following us on [LinkedIn](https://www.linkedin.com/company/pyopensci), [Fosstodon](https://fosstodon.org/@pyOpenSci), and [Bluesky](https://bsky.app/profile/pyopensci.bsky.social). You can also connect with the broader pyOpenSci community on our [Discourse forum](https://pyopensci.discourse.group/). And if you’re interested in our weekly newsletter where we share news, blog posts, and monthly updates, [subscribe on LinkedIn](https://www.linkedin.com/build-relation/newsletter-follow?entityUrn=7179551305344933888).

0 commit comments

Comments
 (0)