View source for User:Rand Linden/Flagged Revs Configuration

{{Alert Box| This article reflects our goals and intentions, but the details are subject to change as a result of implementation and testing.}}

== 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
* [http://en.wikipedia.org/wiki/Wikipedia:Flagged_revisions/Trial 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 will enable revision control on pages in the main and Help namespaces (this will make it available, but not necessarily used for pages in these namespaces).  In these namespaces, only pages designated by a reviewer will be under revision control: in general, these will be articles imported from the Knowledge Base.

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

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

=== User groups ===

Mediawiki enables you to define "user groups" and corresponding [http://wiki.secondlife.com/wiki/Special:ListGroupRights 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.

Once we have installed Flagged Revs, the wiki will have the following user groups:

{|class="lltable" border="1"
|--
!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):

{| class="lltable" border="1"
|---
! Metric
! Level 0
! Level 1
! Level 2
! Level 3
! Level 4
! Level 5

|--
| Accuracy
| Unreviewed
| Inaccurate
| Widespread inaccuracies
|style="background: #CDCDCD"| Somewhat accurate
| Almost accurate
| Totally accurate

|---
| Completeness
| Unreviewed
| Incomplete
| Possibly missing information 
|style="background: #CDCDCD"| Fairly complete
| Almost complete
| Complete

|---
| Clarity
| Unreviewed
| Unclear
| Widespread clarity problems
|style="background: #CDCDCD"| 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.