User:Rand Linden/Flagged Revs Configuration
 |
This article is obsolete, but kept as a historical record. Do not rely on this information in any way. However, it may be used in the future, so please do not delete or modify.
|
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
- http://meta.wikimedia.org/wiki/Flagged_Revisions
- http://www.mediawiki.org/wiki/Help:FlaggedRevs
- Example PHP code of Wikipedia config
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.