User:Rand Linden/Flagged Revs Configuration

Overview

This document provides details on how we plan to use the Flagged Revs extension on the SL wiki. Flagged Revs is complex, highly configurable, and not well documented. For this reason, we will be testing the configuration on an internal "sandbox" wiki to make sure we have the technical parameters correct.

References

Features

Flagged Revs enables 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.

Scope

We enabled revision control on pages in the main and Help namespaces (this makes it available, but not necessarily used for pages in these namespaces). In these namespaces, only pages designated by a reviewer are under revision control: in general, these are articles imported from the Knowledge Base.

To emphasize: only a small subset of pages in the wiki is under revision control. The majority, including almost all current articles is not under revision control, and will remain as they currently are.

Note that we are "protecting" certain articles that document Linden Lab's policy, legal guidelines, terms of service, and so on. Residents are not able to edit such articles at all; though they are be able to contribute to discussions via a corresponding discussion (Talk) page.

User groups

Mediawiki enables you to define "user groups" and corresponding group rights.

Flagged Revs defines two new user groups:

Editors - reviews revisions for vandalism, nonsense, or other graffiti. Can mark an article as sighted, i.e. not containing obvious vandalism. In our configuration, all logged-in users will be automatically put into this category.
Reviewers - validates and revisions more thoroughly for accuracy and completeness. Can mark an article as quality. Linden Lab will "promote" certain users to this group. All sysops will also be in this group.

The wiki has the following user groups:

Group	Capabilities	Who
Everyone	View pages. You don't have to be logged in to view articles.	Everyone
Users	View, edit, and move pages and ability to mark a revision as "sighted," meaning not junk, vandalism, or other inappropriate content.	Any Resident currently logged in to wiki.
Reviewers	User privileges; and review pages for accuracy, clarity, and completeness.	All LL employees and designated Residents.
Sysops	Reviewer privileges; and edit protected pages, un/protect pages, block users, rollback changes, etc.	All LL employees

Stable versus current revisions

Pages that are under revision control can have two different versions:

Current revision - the latest edits, whether reviewed and approved or not. Displayed by default to sysops, and visible via the "Draft" tab to all logged-in users.
Stable revision - the most recent "quality" revision. Displayed by default to all users, whether logged in or not.

NOTE: You can set a user preference to change whether you see stable or current revision by default.

Flags

All LL employees, and "Reviewer" users can rate articles with the following metrics or flags (on a zero to five scale):

Metric	Level 0	Level 1	Level 2	Level 3	Level 4	Level 5
Accuracy	Unreviewed	Sighted	Widespread inaccuracies	Somewhat accurate	Almost accurate	Totally accurate
Completeness	Unreviewed	Incomplete	Somewhat incomplete	Somewhat complete	Almost complete	Complete
Clarity	Unreviewed	Unclear	Somewhat unclear	Somewhat clear	Almost clear	Totally clear

The shaded cells mark the minimum level for a "quality" article.

Quality revision

An article that has been reviewed (flagged) with at least a 3-rating in accuracy, completeness and clarity will be considered "quality" and displayed by default.

Strings

These are string resources used by the Flagged Revs extension. Because they are in the "Mediawiki:" namespace, only administrators can edit them.

New namespace strings