Skip to content

Commit

Permalink
blogpost
Browse files Browse the repository at this point in the history
  • Loading branch information
nabobalis committed Jan 24, 2024
1 parent 1427eb0 commit f198dfd
Show file tree
Hide file tree
Showing 3 changed files with 31 additions and 6 deletions.
11 changes: 5 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,9 +46,9 @@ This must pass before the PR will be merged, furthermore, one review is required
Blog posts can be added by creating a new text file in the `posts/<current year>` directory.
The filename must use the following naming convention `YEAR-MONTH-DAY-title.{ext}` and be written in one of the following formats:

- [RST](https://www.sphinx-doc.org/en/stable/rest.html) formatted text, `ext=rst`,
- [Jupyter notebook](https://jupyter.org/), `ext=ipynb`; (notebooks are converted to RST using the [nbsphinx](https://nbsphinx.readthedocs.io) extension)
- [MD](https://www.markdownguide.org/cheat-sheet/) formatted text, `ext=md`,
- [ReStructuredText (RST)](https://www.sphinx-doc.org/en/stable/rest.html) formatted text, `ext=rst`,
- [Jupyter Notebook (NB)](https://jupyter.org/), `ext=ipynb`; (notebooks are converted to RST using the [nbsphinx](https://nbsphinx.readthedocs.io) extension)
- [Markdown (MD)](https://www.markdownguide.org/cheat-sheet/) formatted text, `ext=md`,

Please also see the [ABlog documentation](https://ablog.readthedocs.io/) for more information.

Expand Down Expand Up @@ -99,7 +99,7 @@ See the [nbsphinx docs](https://nbsphinx.readthedocs.io/raw-cells.html) for info

You might have to open the notebook in a text editor and change the "metadata" for the post cell to include the following

```
```json
"metadata": {
"raw_mimetype": "text/restructuredtext"
},
Expand All @@ -114,7 +114,7 @@ If your notebook requires any other dependencies besides SunPy (or its dependenc

If you write your post in markdown formatted text, each file must contain the following header for Sphinx via [Ablog](https://github.com/sunpy/ablog) to parse the post properly:

```
```markdown
---
blogpost: true
date: <Date>
Expand All @@ -123,7 +123,6 @@ category: <One of the below>
---

# <Title>
```

### Metadata
Expand Down

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

25 changes: 25 additions & 0 deletions posts/2024/2024-01-24-pyopensci.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
blogpost: true
date: Jan 24 2024
author: Nabil Freij
category: Update
---

# pyOpenSci and `sunpy`

![pyOpenSci logo](https://avatars.githubusercontent.com/u/28938222?s=200&v=4)

[pyOpenSci](https://www.pyopensci.org/) is a "diverse community of people interested in building a community of practice around scientific software written in Python".
They are working on improving the information around the packaging and tooling used by the larger community as well to provide support for package maintainers.
There is a review process to become a pyOpenSci accepted package which comes with two extensive reviews from independent members of the wider community.

With this in mind, the SunPy Project decided to submit `sunpy` to pyOpenSci to ensure that it is aligned with the broader Python community that pyOpenSci is building.
As one of the The Project's core aim is to ensure that we are not isolated from this wider community.

[The review](https://github.com/pyOpenSci/software-submission/issues/147) was started on the [pyOpenSci software-submission repository](https://github.com/pyOpenSci/software-submission).
The entire review process is open, with one editor and two reviewers and the entire exchange between the `sunpy` maintainers and them is on that issue.
This process was incredibly helpful as it pointed some miscommunication within our documentation and some choices that were made several years ago but now were redundant or not best practice.

After these issues were fixed, `sunpy` was accepted into pyOpenSci and we added the badge to the `sunpy` readme.
The plan in future is to submit more SunPy Project packages as well as integrate more closely with pyOpenSci to replace our own affiliated package system.
These are still work in progress and will be announced here in due course.

0 comments on commit f198dfd

Please sign in to comment.