You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: how-to/editor-in-chief-guide.md
+20-3Lines changed: 20 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -96,7 +96,21 @@ responding to out-of-scope pre-submissions.
96
96
If the EiC has limited time to handle [pre-review checks](pre-review-checks) for a package, a conflict of interest, or lacks relevant expertise, they may ask another editor to perform initial checks on a package at any time.
97
97
:::
98
98
99
-
## Editor in Chief checklist
99
+
## Editor in Chief pre-review submission checklist
100
+
101
+
The EiC is also responsible for determining the scope of packages submitted via a pre-submission inquiry.
102
+
103
+
The steps include:
104
+
105
+
1.**Determine if the package is in scope for review:** Have a look at the pre-submission inquiry. Use our [project scope page](https://www.pyopensci.org/software-peer-review/about/package-scope.html) to determine whether that package is in scope for pyOpenSci review.
106
+
2. If the package is in scope, add the `submission-requested` label to the pre-submission inquiry.
107
+
3. Let the author know that `pre-review` checks are next and will happen in the full submission issue. At this stage, it's a good idea to let the author know that the package will undergo pre-review checks upon submission for review. You can share the [pre-review checks template with the author at this time if you wish](editor-checklist-template)
108
+
109
+
:::{note}
110
+
It is OK to perform pre-review checks in the pre-review submission if you wish. However, for documentation purposes, you will need to perform them in the full submission issue, as that is what JOSS and other partners look at. Be sure that you aren't duplicating your time!
111
+
:::
112
+
113
+
## Editor in Chief peer review checklist
100
114
101
115
When a new package is submitted for review, the Editor in Chief should:
Copy file name to clipboardExpand all lines: how-to/editors-guide.md
+16-5Lines changed: 16 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -115,11 +115,21 @@ referenced multiple times in the steps below:
115
115
116
116
```
117
117
118
-
### ✔️ 1. First, tag the submission issue on GitHub
118
+
### ✔️ 1. First, tag the submission issue on GitHub & assign yourself to the issue
119
119
120
120
Once you begin the review process as an editor:
121
121
122
122
- Tag the submitted GitHub issue with the `1/editor-checks` tag if it hasn't already been tagged by the editor-in-chief.
123
+
- Make sure that you are assigned to the issue on GitHub (ie, your name is on the right-hand side of the issue as the person running it).
124
+
125
+
:::{figure-md} assign-editor
126
+
127
+
<imgsrc="../images/assign-issue.png"alt="Screenshot showing the right-hand side of a GitHub issue with the editor assigned to the issue."width="700px">
128
+
129
+
Make sure that your name is both listed in the YAML at the top of the issue and also that you are assigned to the issue on GitHub (on the right-hand side of the issue).
130
+
:::
131
+
132
+
123
133
- Check the YAML template at top of the submitted GitHub issue, make sure that mandatory parts of the template are filled out.
124
134
- If elements are incomplete, direct the authors toward filling in any missing pieces.
125
135
@@ -135,17 +145,17 @@ Version submitted: VERSION-SUBMITTED
135
145
```{admonition} Editor in Chief checks for structure & scope should be completed first
136
146
:class: note
137
147
138
-
The editor in chief who initially engaged with this review should have already evaluated the packagelevel Editor Checks section for `Fit`, `Automated Tests`, `Documentation`, `License`, and `Repository`.
148
+
The editor in chief who initially engaged with this review should have already evaluated the package-level Editor Checks section for `Fit`, `Automated Tests`, `Documentation`, `License`, and `Repository`.
139
149
140
150
They also should have checked whether the package is [in scope for pyOpenSci](../about/package-scope).
141
151
And whether there is [functionality overlap with functionality of any other existing Python packages](package-overlap).
142
152
143
-
However, in some instances the editor-in-chief may request that an editor
144
-
perform these tasks. Be sure to check the issue to ensure the above checks have been implemented prior to initiating the review.
153
+
However, in some instances, the editor-in-chief may request that an editor
154
+
perform these tasks. Be sure to check the issue to ensure the above checks have been implemented before initiating the review.
145
155
146
156
If the package does not fit the pyOpenSci scope and policies and needs to be
147
157
rejected, see
148
-
[this section in the editor in chief guide](editor-in-chief-guide.md#responding-to-out-of-scope-submissions)
158
+
[this section in the editor-in-chief guide](editor-in-chief-guide.md#responding-to-out-of-scope-submissions)
149
159
about how to respond.
150
160
```
151
161
@@ -257,6 +267,7 @@ ensure that things are moving smoothly:
257
267
- Check in with reviewers and authors occasionally. Offer clarification and help as needed.
258
268
- Aim for ~3 weeks for review, 2 weeks for subsequent changes, and 1 week for reviewer approval of changes.
259
269
- If a review has not been submitted after 2 weeks, ping the reviewer(s) within the review issue to ensure they are aware of the 3-week deadline.
270
+
- If you are waiting for a maintainer to respond to you, be sure to add the label `pending-maintainer-response` to the issue.
0 commit comments