Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 35 additions & 0 deletions .github/ISSUE_TEMPLATE/blog-post.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
---
name: 📖 Blog post information
about: Capture information we can use for a blog post
title: "[BLOG TITLE HERE]"
labels: ["blog"]
assignees: []
---

<!-- Do your best to fill this out. Just bullet points is fine! -->

### What happened?

- This happened
- This happened

### Why should we be excited about it?

- Because A
- Because B

### Where can we learn more?

- Link A
- Link B

---

<!-- BONUS SECTION: These are optional, but super helpful if you have time! -->

### Media and images
<!-- Drag/drop any images we can use in the post! -->


### Acknowledgements
<!-- Give a shout-out to any person or org that particularly helped. -->
31 changes: 31 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# Contributing to the Jupyter Book Blog

Our blog is our primary mechanism for recording what we do and the impact we've had. It also gives us a record of our work that we can quickly use for generating reports.

## Principles to follow

- Shorter, imperfect, and more frequent
- If you're not sure whether it's in scope, it's probably in scope
- Link to other places to learn more

## Things to blog about

- Examples of Jupyter Book having impact "in the wild"
- Share updates of our work (this can be super small! it is more interesting than you imagine!)
- Share learning and inspiration that's relevant to Jupyter Book

## Share an idea for a blog post

Anybody is encouraged to share blog post ideas! Here are some tips:

- Fill out the [blog post issue template](https://github.com/jupyter-book/blog/issues/new?template=blog-post.md)
- Fill in as much as you can but don't worry about getting it perfect!

## Write a blog post

Anybody is encouraged to write blog posts! Here are some tips:

- Look in the [issues for our blog](https://github.com/jupyter-book/blog/issues?q=sort%3Aupdated-desc+is%3Aissue+is%3Aopen) for things you could blog about.
- Feel free to blog about any of them!
- Do so by adding a new markdown file to the `posts/` folder and making a Pull Request.
- Ping the team for review and editing in Discord.
22 changes: 22 additions & 0 deletions posts/2025-11-13-numpy-tutorials-jb2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
title: NumPy tutorials now built with Jupyter Book 2
date: 2025-11-13
authors:
- name: Jupyter Book Team
---

The [NumPy tutorials site](https://numpy.org/numpy-tutorials/) has upgraded to Jupyter Book 2! The [migration was just merged](https://github.com/numpy/numpy-tutorials/pull/274), bringing MyST-powered documentation to one of scientific Python's foundational libraries.

This work came out of the [Scientific Python Developer Summit in Copenhagen](https://scientific-python.org/summits/developer/2025-nov/) in November 2025. The summit created space for NumPy contributors to share experiences with the broader ecosystem and tackle the migration as a focused, right-sized project.

The NumPy tutorials maintainers agreed to migrate to JB2 because the material focuses on narrative and notebook content and [doesn't need API documentation](https://github.com/jupyter-book/mystmd/issues/1259). Seeing NumPy make this transition is a good sign that JB2 is ready for production use in major open source projects - and that JB2 can cover an even bigger chunk of use-cases once we add [API docs support](https://github.com/jupyter-book/mystmd/issues/1259).

## Acknowledgments

Thanks to [Brigitta Sipőcz](https://github.com/bsipocz) for leading the migration and to the NumPy team for their collaboration in making JB2 better for everyone.

## Learn more

- [NumPy tutorials site](https://numpy.org/numpy-tutorials/)
- [Migration PR](https://github.com/numpy/numpy-tutorials/pull/274)
- [Scientific Python Developer Summit](https://scientific-python.org/summits/developer/2025-nov/)