Skip to content

Updated editors guide #322

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Aug 20, 2025
Merged

Updated editors guide #322

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
56cba53
Updated editors guide to heopfully make it more clear when the review…
Jun 13, 2025
6d57a87
Apply suggestions from code review
lwasser Aug 20, 2025
65e65af
'[pre-commit.ci 🤖] Apply code format tools to PR'
pre-commit-ci[bot] Aug 20, 2025
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
4 changes: 2 additions & 2 deletions appendices/editor-initial-response-template.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@
---

## Editor comments
:wave: Hi @reviewer-one and @reviewer-two! Thank you for volunteering to review
for pyOpenSci! <Add any additional banter here that you wish..>
<Add additional banter here that you wish..>
<In step 3 you will add a welcome message to the reviewers>


### Please fill out our pre-review survey
Expand Down
11 changes: 9 additions & 2 deletions how-to/editors-guide.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -166,6 +166,7 @@ we are using our volunteer reviewer time effectively.

- Add a comment to the issue that contains an **exact** copy of the Editor Response template (see below) filled out with your response to the checks that begin the review.
- Change the label of the issue to `2/seeking-reviewer(s)`
- Note that, at this stage, you likely do not have reviewers yet!

```{include} ../appendices/editor-initial-response-template.md

Expand Down Expand Up @@ -201,7 +202,7 @@ This type of communication just lets the author know that the process is
moving forward. Even if it takes longer to find reviews, authors generally
appreciate the communication and understand it's a volunteer-lead process.

```{admonition} Diversity in the editorial & reviewer team is important
```{admonition} Diversity in the editorial & reviewer team is important
:class: important

Diversity is core to the pyOpenSci mission. As such it's important to have an
Expand All @@ -225,10 +226,15 @@ deadline when you'll move on to looking for someone else to keep the processing
moving.

- Once you have assigned reviewers to the review, you will update the editor response above with:

1. reviewer GitHub handles and
2. the review deadline date.

```{info}
At this point you can add the following to the **Editor Response to Review** under **Editor Comments**:
`:wave: Hi @reviewer-one and @reviewer-two! Thank you for volunteering to review
for pyOpenSci!`
```

- Change the label on the issue to `3/reviewer(s)-assigned`

```{warning}
Expand Down Expand Up @@ -387,6 +393,7 @@ Once the package is accepted by JOSS and the DOI badge resolves properly:
Once the review is complete, you can close the issue. Before doing that:

- Be sure that the issue is correctly tagged with `6/pyOS-approved` (and `9/joss-approved` if authors decided to submit to JOSS and were accepted).

- Check the pyOpenSci website to ensure:

- The package was properly added to the [pyOpenSci website](https://www.pyopensci.org/python-packages/).
Expand Down
Loading