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..fa4657f --- /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. + +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/)