Interacting with EditorialBot¶
The Open Journals’ editorial bot or
@editorialbot on GitHub, is our editorial bot that interacts with authors, reviewers, and editors on JOSS reviews.
@editorialbot can do a bunch of different things. If you want to ask
@editorialbot what it can do, simply type the following in a JOSS
Reviewers checklist command¶
Once a user is assigned as reviewer and the review has started, the reviewer must type the following to get a review checklist:
@editorialbot generate my checklist
@editorialbot’s functionality can only be used by the journal editors.
Assigning an editor¶
Editors can either assign themselves or other editors as the editor of a submission as follows:
@editorialbot assign @editorname as editor
Inviting an editor¶
EditorialBot can be used by EiCs to send email invites to registered editors as follows:
@editorialbot invite @editorname as editor
This will send an automated email to the editor with a link to the GitHub
Adding and removing reviewers¶
Reviewers should be assigned by using the following commands:
# Add a GitHub user to the reviewers of this submission @editorialbot add @username as reviewer or @editorialbot add @username to reviewers # Remove a GitHub user from the reviewers of this submission @editorialbot remove @username from reviewers
Starting the review¶
Once the reviewer(s) and editor have been assigned in the
pre-review issue, the editor starts the review with:
@editorialbot start review
If a reviewer recants their commitment or is unresponsive, editors can remove them with the command
@editorialbot remove @username from reviewers. You can then delete that reviewer’s checklist. You can also add new reviewers in the
REVIEW issue with the command
@editorialbot add @username to reviewers.
Setting the software archive¶
When a submission is accepted, we ask that the authors to create an archive (on Zenodo, figshare, or other) and post the archive DOI in the
REVIEW issue. The editor should ask
@editorialbot to add the archive to the issue as follows:
@editorialbot set 10.0000/zenodo.00000 as archive
Changing the software version¶
Sometimes the version of the software changes as a consequence of the review process. To update the version of the software do the following:
@editorialbot set v1.0.1 as version
Changing the git branch¶
Sometimes the paper-md file is located in a topic branch. In order to have the PDF compiled from that branch it should be added to the issue. To update the branch value do the following (in the example, the name of the topic branch is topic-branch-name):
@editorialbot set topic-branch-name as branch
Changing the repository¶
Sometimes authors will move their software repository during the review. To update the value of the repository URL do the following:
@editorialbot set https://github.com/ORG/REPO as repository
Editors can ask EditorialBot to check if the DOIs in the bib file are valid with the command:
@editorialbot check references
EditorialBot can verify that DOIs resolve, but cannot verify that the DOI associated with a paper is actually correct. In addition, DOI suggestions from EditorialBot are just that - i.e. they may not be correct.
A series of checks can be run on the submitted repository with the command:
@editorialbot check repository
EditorialBot will report back with an analysis of the source code and list authorship, contributions and file types information. EditorialBot will also detect the languages used in the repository, will count the number of words in the paper file and will look for an Open Source License and for a Statement of need section in the paper.
It is possible to run the checks on a specific git branch:
@editorialbot check repository from branch <custom-branch-name>
Editors can get a checklist to remind all steps to do after the reviewers have finished their reviews and recommended the paper for acceptance:
@editorialbot create post-review checklist
Flag a paper with query-scope¶
Editors can flag a paper with query-scope with the command:
@editorialbot query scope
Recommending a paper for acceptance¶
JOSS topic editors can recommend a paper for acceptance and ask for the final proofs to be created by EditorialBot with the following command:
On issuing this command, EditorialBot will also check the references of the paper for any missing DOIs.
Only the JOSS editors-in-chief can accept, reject or withdraw papers.
Accepting a paper¶
If everything looks good with the draft proofs from the
@editorialbot recommend acceptance command, JOSS editors-in-chief can take the additional step of actually accepting the JOSS paper with the following command:
EditorialBot will accept the paper, assign it a DOI, deposit it and publish the paper.
Updating an already accepted paper¶
If the draft has been updated after a paper has been published, JOSS editors-in-chief can update the published info and PDF with the following command:
EditorialBot will update the published paper and re-deposit it.
Rejecting a paper¶
JOSS editors-in-chief can reject a submission with the following command:
Withdrawing a paper¶
JOSS editors-in-chief can withdraw a submission with the following command:
The complete list of available commands¶
# List all available commands @editorialbot commands # Add to this issue's reviewers list @editorialbot add @username as reviewer # Remove from this issue's reviewers list @editorialbot remove @username from reviewers # Get a list of all editors's GitHub handles @editorialbot list editors # Assign a user as the editor of this submission @editorialbot assign @username as editor # Remove the editor assigned to this submission @editorialbot remove editor # Remind an author or reviewer to return to a review after a # certain period of time (supported units days and weeks) @editorialbot remind @reviewer in 2 weeks # Check the references of the paper for missing DOIs @editorialbot check references # Perform checks on the repository @editorialbot check repository # Adds a checklist for the reviewer using this command @editorialbot generate my checklist # Set a value for version @editorialbot set v1.0.0 as version # Set a value for archive @editorialbot set 10.21105/zenodo.12345 as archive # Set a value for branch @editorialbot set joss-paper as branch # Set a value for repository @editorialbot set https://github.com/org/repo as repository # Invite an editor to edit a submission (sending them an email) @editorialbot invite @(.*) as editor # Generates the pdf paper @editorialbot generate pdf # Generates a LaTeX preprint file @editorialbot generate preprint # Creates a post-review checklist with editor and authors tasks @editorialbot create post-review checklist # Recommends the submission for acceptance @editorialbot recommend-accept # Accept and publish the paper @editorialbot accept # Update an accepted paper @editorialbot reaccept # Reject paper @editorialbot reject # Withdraw paper @editorialbot withdraw # Flag submission with questionable scope @editorialbot query scope # Get a link to the complete list of reviewers @editorialbot list reviewers # Open the review issue @editorialbot start review # Ping the EiCs for the current track @editorialbot ping track-eic