Help:Extension:FlaggedRevs

is an extension to the MediaWiki software that allows a wiki to monitor the changes that are made to pages, and to more carefully control the content that is displayed to the wiki's readers. When FlaggedRevs is enabled on a page, each subsequent version of the page can be 'flagged' by certain editors and reviewers, to indicate that it has been reviewed and found to meet whatever criteria the wiki requires. A wiki can use a scale of such flags, with only certain users allowed to set each flag.

The ability to flag revisions makes it easier to co-ordinate the process of maintaining a wiki, since it is much clearer which edits are new (and potentially undesirable) and which have been 'accepted' as constructive. In addition, however, it is possible to configure pages so that only revisions that are flagged to a certain level are visible when the page is viewed by readers; hence changes made by users who cannot flag the resulting version to a high enough level remain in a 'draft' form until the revision is flagged by another user who can set a higher flag.

FlaggedRevs is extremely flexible and can be used in a wide range of configurations; it can be discrete enough to be almost unnoticeable, or it can be used to very tightly control a wiki's activity.

Terminology
FlaggedRevs makes use of a set of terms that need to be understood in relationship to how they relate to the software and how they are utilized by users. The terms themselves are fully customizable to allow for language differences and may be accessed using clickable user links; but it is helpful if the basic functions are understood.

FlaggedRevs allows wikis to define "flags" that can be applied to revisions of a page to indicate that the edit didn't contain obvious vandalism. For articles in the flag group, patrol and autopatrolother is disabled and talkpages are not flagged.
 * Flags and flagging

Sighted versions
When FlaggedRevs are enabled, two new user rights are created: Reviewer and AutoReviewer. It is important to note the difference between the edit right and the reviewer right. A request of change in user rights is handled by administrators and can be made on the page de:Wikipedia:Gesichtete Versionen/Rechtevergabe (Sighted versions/User rights)
 * de:Wikipedia:Gesichtete Versionen (live), pl:Wikipedia:Wersje_przejrzane (live), en:Wikipedia:Flagged revisions/Sighted versions (proposed)
 * User rights

The edit right is the ability to edit an article. The reviewer right is the ability to mark the edit as non obvious vandalism and a flag is set as "sighted".
 * Edit
 * Reviewer
 * The reviewer right is automatic given by the system:
 * PL: 500 edits 90 days no blocks.
 * DE: 300 edits 60 days no blocks.

The autoreviewer right is the ability to automark own edits as non obvious vandalism and a flag is set as "sighted".
 * Autoreviewer


 * Surveyor (administrators)
 * Review revisions to "sighted level". Some control over the values of the tags can still be exercised to an extent.
 * Patrol non-reviewable pages
 * Access to the list of Unreviewed Pages (lets users see unreviewed pages, reviewed pages that have unreviewed changes, and a category filter)

The "Stable" version of a page is the last version that was both flagged, and was flagged to a high enough level to be the version immediately visible on the page to all users. So if a page is configured to display all edits immediately, then the most recent flagged revision of any sort will be the stable version. You can link directly to the stable or current versions of a page, by appending &stable=0 or &stable=1 to the url.
 * Stable

Quality versions
The Qreviewer right is the ability to mark a specific version of an article as to "quality"
 * en:Wikipedia:Flagged revisions/Quality versions, de:Wikipedia:Geprüfte Versionen
 * QReviewer


 * Reviewer's widget
 * Draft
 * Sighted
 * Accuracy
 * Quality page

Viewing
FlaggedRevs allows a wiki to mark each revision of a page with a flag to indicate its quality or validity, and to control which revisions are shown by default on a page. Each page where FlaggedRevs is enabled is effectively given two alternative aliases; these are the "stable" version, which is the latest version that has been flagged to a sufficiently high level, and the "current" version, which is the most recent revision, flagged or not. Readers can access either version of the page by adding &stable= to the URL in the address bar, setting &stable=0 for the current version, and &stable=1 for the stable version. On each alias, there is an explanation and a link to the other version.

Wiki developers can control which alias is displayed to users and readers by default, and which flags allow a version to be considered 'stable'. Registered users can customise which alias they see by default in their User Preferences.

Editing
FlaggedRevs does not affect a user's ability to edit a page; only the way the resulting version is handled by the wiki.