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 their quality or to mark them as constructive.
 * Flags and flagging

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

When FlaggedRevs are enabled, two new user rights are created: Editor and Reviewer. It is important to note the difference between the edit right and the editor right.
 * User rights

The edit right is the ability to edit an article.
 * Edit

The editor right is the ability to mark a specific version of an article as "sighted".
 * Editor

The reviewer right is the ability to mark a specific version of an article as to "quality"
 * Reviewer


 * 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, 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.

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