Informatics Educational Institutions & Programs
This page contains a technical description of how the peer review process functions, and a list of templates and other tools associated with peer review. Templates for editorsAdvertisementThe following template may be used to advertise the peer review process: BarnstarThere is a barnstar to thank editors who have made a significant contribution to peer review, or who have contributed a high quality peer review. To use the barnstar, copy and paste the following onto an editor's talk page:
To celebrate an editor who has contributed a great peer review, copy and paste the following, and then include the article's name:
In both examples, the compliment can be changed if required, for example:
UserboxCopying
For volunteers, adding
WelcomeTo welcome a user, copy Backlog templatesTwo sidebars display backlogs:
Closure scriptDeveloped by User:Writ Keeper, there is a script to help automate closing peer reviews. To use the script:
Technical templates All pages have the following two templates are on all peer review process pages:
ShortcutsThe following shortcuts are used to represent the peer review process:
Edit noticesEdit notices are displayed to editors who are making edits on these pages:
DocumentationTemplates used in the peer review process are listed here: The documentation page for the template set is here: Template:CF/doc Review listTo transclude the review list onto new pages:
Peer review process - technical detailsThis section is intended to document the technical processes that make peer review work. It is not intended as instructions for editors. Instructions can be found here. When a review is createdEditors request a peer review by putting {{subst:PR}} onto an article's talk page. The template displays a choice of topics for the review which the user can choose from. Clicking on a topic will create a new page for the review. The new page is preloaded based on the article's topic from templates {{Peer review/preload1}} to {{Peer review/preload10}} These templates create a review by including {{subst:Peer review/subst}}, {{Peer review page|topic=X}}, and some text. "Subst" uses subtemplates to:
How reviews are displayedThe page for the peer review is added to a category via {{Peer review page}}, which is included on every review page. Based on the short name of the topic (eg 'langlit') the page is added to a category relating to the topic. The category is named based on the topic's full title (eg. 'Language and literature peer reviews'). This is done via the template {{Peer review/Topic}}. A bot called AnomieBOT (operated by Carl) automatically creates a page listing all the reviews in each category. Reviews are listed in a unique format. Each review is recorded chronologically alongside the alongside the name of the item , its namespace number, and a timestamp indicating when it was added to the category. Reviews are formatted according to {{PRentry}}. The short name, long name, category and listing are displayed below.
The list of reviews is then transcluded onto a page in a human-readable format. The full list, separated by subject area, is fully transcluded at: Wikipedia:Peer_review/List_of_active_reviews. A parameter called 'mode' can be used to set the format of how reviews display.
How a review is closedWhen a review is closed, two things happen:
MaintenanceThis page is intended to provide information on how to maintain the peer review process. Updating the monthly archiveFrom February 2015, links to archived peer reviews are provided in category form at Wikipedia:Peer review/Archive. To update the archive for this month:
Troubleshooting: The peer review page is listed as a peer reviewIt happens from time to time that the peer review page is placed in one of the categories for articles under peer review. This causes the peer review page to list itself as a peer review, which is obviously not a good thing (thankfully, the servers do not admit infinite regress, and simply give up trying to display content). There are several ways this can happen, but they usually involve an individual peer review placing itself in a peer review category, without surrounding this category by "noincludes". Since the review is transcluded on the peer review page, the category gets added to the peer review page too. To find the culprit, visit the AnomieBOT page corresponding to the topic under which the entire peer review page is listed, and look for strange entries. The entry immediately below the mess is likely to be the cause of the problem. Troubleshooting: "Wikipedia:Peer review is getting full"Wikipedia has a limit to how much information can be transcluded onto a page. That is called the post-expand size. This takes into account the reviews that are transcluded and anything that is transcluded onto the review pages (... and anything transcluded onto those pages, and so on). When the post-expand size is about to be reached, AnomieBOT will start posting messages on the peer review talk page. What to do about this?
Troubleshooting: No reviews are transcludedThis occurs when the "post-expand size" has been exceeded. See above for methods for dealing with this. Troubleshooting: A review is "too long" to display in fullIn 2015 there came a number of times when the peer review process was so active that the post-transclusion size (see above) was exceeded, or close to being exceeded. At the time, all reviews were always transcluded in full. This was very problematic, because if exceeded editors would not be able to see the list of active reviews. Even closing reviews that were inactive would leave too many reviews open. In order to prevent this, reviews that were over a certain arbitrary length would instead display a message that they were "too long" to display in full. Being so long, such reviews are likely already to be active and are unlikely to benefit as much from being transcluded in full. Troubleshooting: My review doesn't display on the 'unanswered reviews' listThe unanswered reviews list is automated. It only displays reviews where the date of creation matches the date of the last edit, ie. if they have not been edited. If your review isn't displaying, it is probably because you've made a slight change to your request (even a small as correcting a typo). Please add your review to the list of reviews not displaying here: Template:Peer review/Unanswered peer reviews sidebar |
