From 88dfb485bde69202acb5086f7ca6940d38323a5b Mon Sep 17 00:00:00 2001 From: choldgraf Date: Thu, 13 Nov 2025 11:13:03 -0800 Subject: [PATCH 1/2] Blog post about numpy tutorials and lightweight contributing guide --- .github/ISSUE_TEMPLATE/blog-post.md | 35 +++++++++++++++++++++++++ CONTRIBUTING.md | 31 ++++++++++++++++++++++ posts/2025-11-13-numpy-tutorials-jb2.md | 22 ++++++++++++++++ 3 files changed, 88 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/blog-post.md create mode 100644 CONTRIBUTING.md create mode 100644 posts/2025-11-13-numpy-tutorials-jb2.md diff --git a/.github/ISSUE_TEMPLATE/blog-post.md b/.github/ISSUE_TEMPLATE/blog-post.md new file mode 100644 index 0000000..0999de9 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/blog-post.md @@ -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: [] +--- + + + +### 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 + +--- + + + +### Media and images + + + +### Acknowledgements + diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..cdd736c --- /dev/null +++ b/CONTRIBUTING.md @@ -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. diff --git a/posts/2025-11-13-numpy-tutorials-jb2.md b/posts/2025-11-13-numpy-tutorials-jb2.md new file mode 100644 index 0000000..b8ab17e --- /dev/null +++ b/posts/2025-11-13-numpy-tutorials-jb2.md @@ -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. + +Many projects are hesitant to move from Sphinx. NumPy tutorials are a great fit for JB2 because they focus on narrative content and [don'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. + +## 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/) From c6a2b669c23fe3650dee7d64b0d39424864f9c6f Mon Sep 17 00:00:00 2001 From: choldgraf Date: Mon, 17 Nov 2025 16:06:37 -0800 Subject: [PATCH 2/2] address comments --- posts/2025-11-13-numpy-tutorials-jb2.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/posts/2025-11-13-numpy-tutorials-jb2.md b/posts/2025-11-13-numpy-tutorials-jb2.md index b8ab17e..fa4657f 100644 --- a/posts/2025-11-13-numpy-tutorials-jb2.md +++ b/posts/2025-11-13-numpy-tutorials-jb2.md @@ -9,7 +9,7 @@ The [NumPy tutorials site](https://numpy.org/numpy-tutorials/) has upgraded to J 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. -Many projects are hesitant to move from Sphinx. NumPy tutorials are a great fit for JB2 because they focus on narrative content and [don'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. +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