Jump to content

Help:EasyPeerReview

From Wikinews, the free news source you can write!

The Easy Peer Review (EzPR) gadget lets Wikinews reviewers report the results of the five core checks and either publish or mark an article not ready with clear next steps.

What EzPR does

  • Displays a compact review form for Copyright · Newsworthiness · Verifiability · NPOV · Style.
  • Reviewers select for each; Pass / Fail / Not reviewed and may add short notes.
  • EzPR then reports the findings automatically:
  • All Pass → inserts {{publish}}, removes develop/review templates, sets {{date}} to current, sights the new revision, and logs a pass on the talk page.
  • Any Fail → replaces {{review}} with {{tasks|…}} and posts a not‑ready section on the talk page listing failed areas and reviewer comments.

Who can use it

  • Designed for reviewers (users with the editor or facilitator right).
  • Works only in the Main namespace and when viewing a page containing {{Review}}.
  • The Review link appears when the page includes a review trigger (such as {{Review}} with id="review".

Enable the gadget

The Easy Peer Review gadget will be automatically enabled for you if you are a reviewer. You do not need to enable it manually.

For non-reviewers, loading the gadget in your common.js will not work, because the gadget checks whether the user is a reviewer and only activates itself if that condition is met.

mw.loader.load('/w/index.php?title=MediaWiki:Gadget-easyPeerReview.js&action=raw&ctype=text/javascript');

How to use it

EzPR User Interface
EzPR User Interface
  1. Open the article draft in Main and confirm it’s ready (has {{review}}).
  2. Click the Review link under Actions in the sidebar
  3. Read the talk page and tick the checkbox.
  4. For each criterion, choose Pass / Fail / Not reviewed; add a brief note for any Fail.
  5. Add overall comments.
  6. Click Submit Review.

EzPR reports your review:

  • Pass: publishes the article and enables flagged revisions (requires all subsequent edits to be sighted, or approved by a reviewer; logs “Review of revision … [Passed]” with your notes.
  • Not ready: flags article with {{Tasks}}; logs “Review of revision … [Not ready]” with your notes on the talk page.

Reviewer checklist (brief overview)

See also: Review checklist
  • Copyright: no copyright violations or Plagiarism; quotes minimal and attributed.
  • Newsworthiness: timely focal event; lede answers 5Ws+H.
  • Verifiability: at least two independent, reliable sources; every fact verifiable; avoid unattributed analysis.
  • NPOV: attribute opinions, analysis, and motive; reflect significant perspectives; avoid a single source’s framing.
  • Style: follows Style guide (downstyle headline, past tense, correct date formats, italic titles of works, clear sources section, etc).

Note: Reviewers verify, evaluate, and report; they do not perform major article development. Use {{Tasks}} and the review summary notes to guide authors toward fixes.

Troubleshooting

  • No Review link: ensure the page is in Main namespace, contains a review trigger, and that you have the required rights.
  • Edit conflict on submit: another edit landed first; EzPR prompts whether to continue with the latest revision.
  • Publish failed: manually insert {{publish}} and sight the latest revision.
  • Sighting incomplete: sight manually via page history.

If published

When published, the following is also done:

  • Removes {{develop}}
  • Removes {{review}} / {{under review}} / {{quick review}} / {{breaking review}}
  • Adds {{publish}} after the last {{source…}} entry
  • Updates date to the current date with: {{date|{{subst:#time:F j, Y}}}}
  • EzPR also initializes the Comments page from the standard local template.

Full source

Use the canonical version at MediaWiki:Gadget-easyPeerReview.js. For testing, copy it to User:YourName/EzPR-sandbox.js and load it from your common.js. Remove it when finished testing.

See also

Historical PDF. Not really the anatomy of a review, but the EzPR user interface