This page is for helping a directorate secretary manage review assignments via the Datatracker Review Tool.
Basics for accessing the Review Tool -- This page assumes that you have secretary permissions and that you are logged in.
If your review directorate is already set up, your directorate's review page can be found at: https://datatracker.ietf.org/group/[directorate-name]
To create a directorate, please contact email@example.com. You will probably also want a mailing list in addition to a review tool.
To help with the setup, the following questions should be answered:
The Secretary settings tab allows you to set the following:
Providing Team Information
You can provide information about your team by going to the About tab and editing the following:
The About section of the page is added by the Secretariat. Please contact firstname.lastname@example.org to provide text.
To customize the email message, contact email@example.com.
Closing or Reassigning Assignments
Assignments are automatically closed if the reviewer uses the review tool to submit their review.
Sometimes a reviewer won't be able to complete an assignment or doesn't complete an assignment (as shown in the Deadline column on https://datatracker.ietf.org/group/[directorate-name]/reviews/).
To close or reassign:
When a secretary adds a reviewer, the reviewer has the ability to update their settings (how often they want an assignment, when they are unavailable, if they would like reminders, etc.) This is covered on the Datatracker Review Tool How-to page. Please point a new reviewer to this page so they can customize their settings. The secretary will receive email when the reviewer adjusts their review frequency or unavailability information.
The secretary can also make updates to the reviewer's settings:
To see an overview of the reviewers' assignments, completed reviews, and settings, go to https://datatracker.ietf.org/review/[directorate-name]/reviewers/.
Giving a Reviewer Time Off
When making a BIG assignment (more than 200 pages, for instance), you can give the reviewer a break by clicking "Skip next time" check box. This will take them out of review rotation for one rotation.
Note: Keep an eye on this. This has been a fragile part of the tool in the past (reviewers get stuck, the queue rotation starts acting odd...).
When a reviewer leaves the team, go to the Edit Group tab and click the x next to their name. This will send email to the reviewer, chair, and secretaries, and remove the reviewer from the tool.
Log into trac to see the current list of bugs and enhancements for the Datatracker Review Tool.
The content of this page was last updated on 2022-06-03. It was migrated from the old Trac wiki on 2023-01-24.