feat(blog): add bssw blog to site

Author: lwasser

README.md

@@ -53,16 +53,16 @@ For MAC:
 Linux:
 `sudo apt-get install imagemagick`
 
-You can convert a directory of PNG images associated with a
-blog post that you write using:
+You can convert a directory of `.png` images associated with a
+blog post that you write using the following bash command:
 
 `for file in *.png; do cwebp "$file" -o "${file%.*}.webp"; done`
 
-or a single image
+or you can convert a single image:
 
 `cwebp input-image.png -o output-image.webp`
 
-Below is an example of adding a figure to a post that has both webp and .png formats to support older and newer browsers.
+Below is an example of how to add figure to a post that supports both `.webp` and `.png` formats. Providing both allows the website to be backwards-compatible with older browsers.
 
 ```html
 <figure>
@@ -74,10 +74,12 @@ Below is an example of adding a figure to a post that has both webp and .png for
 ```
 ## How to update blog post last_updated field
 
-We have a script that will automatically update the last_updated field for all of our blog posts. To run it use:
+We have a bash script that will automatically update the `last_updated` field in the YAML for all of our blog posts. To run it use:
 
 `./scripts/date-updated.sh`
 
+Note: it would be nice to add this into our CI build but right now we do not have that setup. So we just need to run this script periodically to update the `last_updated` field when we update a blog post.
+
 ## Contributors ✨
 
 Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

_posts/2025-03-18-contribute-to-open-source-github-lessons.md

@@ -0,0 +1,128 @@
+---
+layout: single
+title: "Contribute to Open Source Software: It's  More Than just Code"
+excerpt: "Contributing to open source isn’t just about code—it’s also about navigating social norms. Discover pyOpenSci’s new Contribute to Open Source lessons, which cover both the technical and social aspects, and are free for anyone to use."
+author: "Leah Wasser"
+permalink: /blog/contribute-to-open-source-lessons.html
+header:
+  overlay_image: images/headers/pyopensci-inessa.png
+  overlay_filter: rgba(20, 13, 36, 0.3)
+categories:
+  - blog-post
+  - community
+  - contribute-to-open-source
+classes: wide
+toc: true
+comments: true
+last_modified: 2025-03-11
+---
+
+
+## Beyond code: the social side of open source
+
+When you think about contributing to open source, you might assume the biggest hurdle for newcomers is technical--learning Git, using GitHub, and/or writing code. Most contribute to open source guides focus on technical skills. But for many new contributors, the challenge isn’t only technical—it’s social too.
+
+Receiving open feedback on your contributions in the form of code review, whether code or documentation, [creates anxiety for  many](https://osf.io/preprints/psyarxiv/8k5a4_v1).
+
+- <i class="fas fa-user-plus" style="color:#81c0aa;"></i> **Joining an unfamiliar community:** Understanding who to reach out to and how the project operates can feel intimidating.
+- <i class="fas fa-comments" style="color:#81c0aa;"></i> **Understanding unspoken norms:**  Every project has its own culture, from how discussions happen to how decisions are made. And these norms are not always well-documented.
+- <i class="fas fa-handshake" style="color:#81c0aa;"></i> **Building confidence in a new space:** Many contributors worry about making mistakes, be it while using GitHub or submitting a Pull Request or even in the content updates themselves.
+- <i class="fas fa-exclamation-circle" style="color:#81c0aa;"></i> **Navigating constructive feedback** – Open source is built on open peer review; however, receiving public feedback on a contribution can be intimidating.
+
+
+In my 10+ years of building and maintaining software, contributing to projects, and running beginner-friendly sprints, I’ve seen firsthand that communication, collaboration, and project culture are just as—if not more—important than technical skills. I've also experienced the imposter syndrome first-hand. I was nervous about my first contributions and wasn't sure how to start contributing in a meaningful way.
+
+**Technical and social skills go hand in hand.** Open source communities are most productive when contributors and maintainers recognize this balance between the technical and social skills associated with contributing. In most cases, all of the people involved in the project are volunteers with varying priorities, skillsets, and motivations to participate.
+{: .notice .notice--info}
+
+### Developing our contribute to open source lessons
+
+This past year, with support from the [Better Software for Science (BSSw) Fellowship](https://bssw.io/fellows/leah-wasser), I developed lessons shaped by insights gained from the [pyOpenSci contributor community](https://www.pyopensci.org/our-community/index.html). Our lessons are now freely available as open educational resources designed to help contributors and maintainers foster a more welcoming, collaborative and productive open source community.
+
+<a href="https://www.pyopensci.org/lessons/contribute-open-source/index.html" class="btn btn--success">Check out our lessons now.</a>
+
+> BSSw is a unique partnership between the National Science Foundation (NSF) and the Department of Energy (DOE) that provides small grants to advocates in the scientific open source space.
+{: .notice }
+
+### A community-driven approach to open source
+
+Over the past two years, **pyOpenSci has welcomed over 300 contributors**, with more than **120 issues and pull requests** submitted during our [beginner-friendly sprints](/blog/pyopensci-pyconus-2024-sprints.html). These experiences reinforced what we already knew—technical skills are just one part of people successfully contributing to open source.
+
+Through our sprints, we saw firsthand how **clear guidance, supportive communities, and transparent contribution processes** helps newcomers gain confidence. Often, they stick around our community after the events. These insights shaped our *Contribute to Open Source* lessons.
+
+## Beyond code: The social skills of open source
+
+Our lessons address both the technical and social aspects of contributing to open source.
+
+### For contributors: how to navigate your first contribution
+
+For contributors, we focus on:
+1. Understanding the technical steps surrounding making your first contribution
+2. Signals that tell you that a project welcomes newcomers and,
+3. What to expect as they navigate their first contributions.
+
+A few highlights include:
+
+- <i class="fas fa-book" style="color:#81c0aa;"></i> **[Get to know a repository](https://www.pyopensci.org/lessons/contribute-open-source/get-to-know-repo.html):** Learn how to look for documentation files like `CONTRIBUTING` and `DEVELOPMENT` guides that will become your guiding light in making your first contributions. These files should help you understand whether new contributions are welcome, what the contribution process is, and what types of contributions are welcome.
+- <i class="fas fa-search" style="color:#81c0aa;"></i> **[Find and understand issues](https://www.pyopensci.org/lessons/contribute-open-source/identify-issue.html):** Explore how to search and create GitHub issues as you begin the process of finding a task to work on. Learn how to communicate effectively with maintainers who you may have never interacted with before.
+- <i class="fas fa-code-branch" style="color:#81c0aa;"></i> **[Create effective pull requests](https://www.pyopensci.org/lessons/contribute-open-source/pull-request.html):** Learn how to open a pull request, write clear pull request messages titles and descriptions. Also, learn how to make the pull request process more efficient by reviewing your own work and linking your PR to an issue to streamline maintainer review.
+
+### For Maintainers: Creating a contributor-friendly repository
+
+While these lessons are focused on contributing, we also provide some maintainer tips to help set clear expectations for contributors:
+
+- <i class="fas fa-comments" style="color:#81c0aa;"></i> **Communicate your availability:** Let contributors know if you have time to support them. It’s okay if you're busy—just set clear expectations!
+- <i class="fas fa-file-alt" style="color:#81c0aa;"></i> **Provide clear guidelines:** Add `CODE_OF_CONDUCT`, `CONTRIBUTING`, and `DEVELOPMENT` files to define what contributions you welcome and how contributors should engage with your project.
+- <i class="fas fa-tools" style="color:#81c0aa;"></i> **Use automation to support contributors:** Tools like [pre-commit.ci](https://pre-commit.ci/) help automate formatting and linting, reducing friction for new contributors.
+
+## Co-Creating open source contribution lessons
+
+Our *Contribute to Open Source* lessons, like all pyOpenSci resources, are co-developed collaboratively. By bringing together contributors with different backgrounds and skill levels, we ensure our materials are clear, accurate, and welcoming.
+
+A diverse contributor base makes our lessons stronger:
+* <i class="fas fa-microscope" style="color:#81c0aa;"></i> **Experts** provide technical accuracy.
+* <i class="fas fa-user-graduate" style="color:#81c0aa;"></i> **Beginners** ensure content is approachable.
+* <i class="fas fa-users" style="color:#81c0aa;"></i> **Everyone in between** help refine and improve the content.
+
+This same community-driven approach shaped our [packaging guide](https://www.pyopensci.org/python-package-guide/), which covers [packaging tools](https://www.pyopensci.org/python-package-guide/package-structure-code/python-package-build-tools.html) and [tutorials](https://www.pyopensci.org/python-package-guide/tutorials/intro.html). Like our lessons, it was co-developed and openly reviewed to ensure accessibility and clarity.
+
+<figure>
+    <picture>
+    <source srcset="/images/peer-review/co-development-open-education.webp" type="image/webp">
+    <img src="/images/peer-review/co-development-open-education.png" alt="A diagram illustrating the co-development of open lessons by pyOpenSci. The diagram consists of a circular section divided into five segments labeled ‘Maintainers,’ ‘Beginners,’ ‘Experts,’ ‘Researchers,’ and ‘Contributors,’ surrounding a central section labeled ‘Moderation.’ An arrow extends from the circle to the right, labeled with key moderation activities such as ‘Listen,’ ‘Moderate,’ ‘Facilitate,’ ‘Structured review,’ and ‘Code of Conduct,’ leading to ‘Accessible Lessons.’ The background features a subtle floral pattern.">
+    </picture>
+</figure>
+
+By openly co-developing and refining these resources together, we’re making scientific open source more accessible for everyone.
+
+## What's next? Broadening participation in open source
+
+With [PyCon US](https://us.pycon.org/2025/) and SciPy on the horizon, we’re excited to put these lessons into action. At our upcoming sprints, we’ll work together to **refine these resources—improving the lessons and packaging guide to make participating open source even more accessible.**  If you plan to be at either meeting, keep an eye out for pyOpenSci events!
+
+<div class="notice" markdown="1">
+
+## <i class="fa-solid fa-users-line"></i> Connect with us!
+
+There are lots of ways to get involved if you are interested!
+
+* If you read through our lessons and want to suggest changes, open an issue in our [lessons repository here](https://github.com/pyOpenSci/lessons)
+* [Volunteer to be a reviewer for pyOpenSci's software review process](https://forms.gle/GHfxvmS47nQFDcBM6)
+* [Submit a scientific Python package to pyOpenSci for peer review](https://www.pyopensci.org/software-peer-review/how-to/author-guide.html#submit-your-package-for-peer-review)
+* [Donate to pyOpenSci](https://give.communityin.org/pyopensci_2024) to support scholarships for future training events and the development of new learning content.
+* Check out our [volunteer page](/volunteer.html) for other ways to get involved.
+
+You can also:
+
+* Keep an eye on our [events page](/events.html) for upcoming training events.
+
+Follow us on social platforms:
+
+* [<i class="fa-brands fa-discourse" style="color:#81c0aa;"></i> Discourse](https://pyopensci.discourse.group/)
+* [<i class="fa-brands fa-mastodon" style="color:#81c0aa;"></i> Mastodon](https://fosstodon.org/@pyopensci)
+* [<i class="fa-solid fa-cloud" style="color:#81c0aa;"></i> Bluesky](https://bsky.app/profile/pyopensci.bsky.social)
+* [<i class="fa-brands fa-linkedin" style="color:#81c0aa;"></i> LinkedIn](https://www.linkedin.com/company/pyopensci)
+* [<i class="fa-brands fa-github" style="color:#81c0aa;"></i> GitHub](https://github.com/pyOpenSci)
+
+If you are on LinkedIn, check out and [subscribe to our newsletter, too](https://www.linkedin.com/newsletters/7179551305344933888/?displayConfirmation=true).
+
+</div>