Skip to content
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.

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

Stubbing out onboarding call guide #1308

Merged
merged 11 commits into from
Jan 30, 2024
87 changes: 87 additions & 0 deletions docs/editing.md
Original file line number Diff line number Diff line change
Expand Up @@ -437,3 +437,90 @@ Try to check in on your JOSS submissions twice per week, even if only for 5 minu
**Leave feedback on reviewers**

Leave feedback on the [reviewers application](https://reviewers.joss.theoj.org/) at the end of the review. This helps future editors when they're seeking out good reviewer candidates.

## Onboarding a new JOSS editor

All new editors at JOSS have an onboarding call with an Editor-in-Chief. You can use the structure below to make sure you highlight the most important aspects of being an editor.

**Thing to check before the call**

- Have they reviewed or published in JOSS before? If not, you'll need to spend significantly more time explaining how the review process works.
- Check on their research background (e.g., what tracks they might edit most actively in).
- Make sure to send them the [editorial guide](https://joss.readthedocs.io/en/latest/editing.html) to read before the call.

###Β The onboarding call

**Preamble/introductions**

- Welcome! Thank them for their application to join the team.
- Point out that this isn't an interview. Rather, this is an informational call designed to give the candidate the information they need to make an informed decision about editing at JOSS.
- 90-day trial period/try out. Editor or JOSS editorial board can decide to part ways after that period.
- No strict term limits. Some editors have been with us for 7+ years, others do 1-2 years. Most important thing is to be proactive with your editing responsibilities.
arfon marked this conversation as resolved.
Show resolved Hide resolved
- Confirm with them their level of familiarity with JOSS/our review process.
- Point out that they *do not* need to make a decision on the call today. They are welcome to have a think about joining and get back to us.

**Share your screen**

- Visit JOSS (https://joss.theoj.org)
- Pick a recently-published paper (you might want to identify this before the call one that shows off the review process well).
- Show the paper on the JOSS site, and then go to the linked review issue.
- Explain that there are *two* issues per submission – the pre-review issue and the main review issue.

**The pre-review issue**

- The 'meeting room for the paper'. Where author meets editor, and reviewers are identified.
- Note that the EiC may have initiated a scope review. The editor should not start editing until this has completed. Also, editors are able to query the scope (as are reviewers) if they think the EiC should have (but didn't).
- Walk them through what is happening in the pre-review issue...
- Editor is invited (likely with GitHub mention but also via email invite (`@editorialbot invite @editor as editor`))
- Once editor accepts they start looking for reviewers.

**Finding reviewers**

- Explain that this is one of the more time-intensive aspects of editing.
- Explain where you can look for editors (your own professional network, asking the authors for recommendations, the [reviewers application](https://reviewers.joss.theoj.org/), similar papers identified by Editorialbot, )
- Point out that we have a minimum of two reviewers, but if more than that accept (e.g., 3/4 then take them all – this gives you redundancy if one drops out).
- Don't invite one reviewer at a time! If you do this, it may take many weeks to find two reviewers who accept. Try 3/4/5 invites simultaneously.
arfon marked this conversation as resolved.
Show resolved Hide resolved

**The review**

- Once both reviewers are assigned, time to get going!
arfon marked this conversation as resolved.
Show resolved Hide resolved
- Encourage reviewers to complete their review in 4-6 weeks.
- Make sure to check in on the review – if reviewers haven't started after ~1-2 weeks, time to remind them.
- Your role as editor is not to do the review yourself, rather, your job is to ensure that both reviewers give a good review.
arfon marked this conversation as resolved.
Show resolved Hide resolved
- Walk the editor through the various review artifacts: The checklist, comments/questions/discussion between reviewers and author, issues opened on the upstream repository (and cross-linked into the review thread).
- Point editors to the ['top tips'](editing.html#top-tips-for-joss-editors) section of our docs. Much of what makes an editor successful is regular check-ins on the review, and nudging people if nothing is happening.
- Do *not* let a review go multiple weeks without checking in.

**Wrapping up the review**

- Once the review is wrapping up, show the candidate the checks that an editor should be doing (reading the paper, suggested edits, asking for an archive etc.).
arfon marked this conversation as resolved.
Show resolved Hide resolved
- Show the `recommend-accept` step which is the formal hand-off between editor and editor-in-chief.
arfon marked this conversation as resolved.
Show resolved Hide resolved

**Show them the dashboard on the JOSS site**

- Point out that this means you *do not* need to stay on top of all of your notifications (the dashboard has the latest information).
- Highlight here that we ask editors to handle 8-12 submissions per year on average.
- ...and that means 3-4 submissions on their desk at any one time (once they have completed their initial probationary period).
- Show them the backlog for a track, and how they are welcome to pick papers from it (ideally oldest first).
- Show them their profile page, and how they can list their tracks there, and also what their availability is.

**Other important things to highlight**

- Don't invite other editors as reviewers. We're all busy editing our own papers...
- Please be willing to edit outside of your specialisms. This helps JOSS run smoothly – often we don't have the 'ideal' editor for a submission and someone has to take it.
- Highlight that editors will have a buddy to work with for the first few months, and that it's very common for editors to ask questions in Slack (and people generally respond quickly).
- Scope reviews only work if editors vote! Please respond and vote on the weekly scope review email if you can. The process is private (authors don't know what editors are saying). Detailed comments are really helpful for the EiCs.

**Wrapping up**

- Make sure you've highlighted everything in the ['top tips'](editing.html#top-tips-for-joss-editors) section of our docs.
- Reinforce that this is a commitment, and thay regular attention to their submissions is absolutely critical (i.e., check in a couple of times per week).
- Ask if they would like to move forward or would like time to consider the opportunity.
- If they want to move forward, highlight they will receive a small number of invites: One to the JOSS editors GitHub team, a Slack invite, a Google Group invite, and an invite to the JOSS website to fill out their profile.
- Thank them again, and welcome them to the team.

**Communicate outcome to EiC**

- Let the EiC know what the outcome was, and ask them to send out the invites to our various systems.
- Work with EiC to identify onboarding buddy.
- Decide who is going to identify the first couple of papers for the editor to work on.