Difference between revisions of "User:Rand Linden/Flagged Revs Configuration"

Latest revision as of 09:24, 5 April 2011

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.

This article is provided for historical reference purposes only.

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

@@ Line 1: / Line 1: @@
-{{Alert Box| This article reflects our goals and intentions, but the details are subject to change as a result of implementation and testing.}}
+{{Archive|This article is provided for historical reference purposes only.}}
 == Overview ==
@@ Line 15: / Line 15: @@
 === 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.
+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 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.
+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 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.
+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 [http://wiki.secondlife.com/wiki/Special:ListGroupRights group rights].
+Mediawiki enables you to define "user groups" and corresponding [[Special:ListGroupRights|group rights]].
 Flagged Revs defines two new user groups:
@@ Line 30: / Line 30: @@
 * '''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:
+The wiki has the following user groups:
 {| {{Prettytable}}
@@ Line 81: / Line 81: @@
 |--
-| Accuracy
+| {{:MediaWiki:Revreview-accuracy}}
-| Unreviewed
+| {{:MediaWiki:Revreview-accuracy-0}}
-| Inaccurate
+| {{:MediaWiki:Revreview-accuracy-1}}
-| Widespread inaccuracies
+| {{:MediaWiki:Revreview-accuracy-2}}
-|style="background: #CDCDCD"| Somewhat accurate
+|style="background: #CDCDCD"| {{:MediaWiki:Revreview-accuracy-3}}
-| Almost accurate
+| {{:MediaWiki:Revreview-accuracy-4}}
-| Totally accurate
+| {{:MediaWiki:Revreview-accuracy-5}}
 |---
-| Completeness
+| {{:MediaWiki:Revreview-completeness‎}}
-| Unreviewed
+| {{:MediaWiki:Revreview-completeness‎-0}}
-| Incomplete
+| {{:MediaWiki:Revreview-completeness‎-1}}
-| Possibly missing information
+| {{:MediaWiki:Revreview-completeness‎-2}}
-|style="background: #CDCDCD"| Fairly complete
+|style="background: #CDCDCD"| {{:MediaWiki:Revreview-completeness‎-3}}
-| Almost complete
+| {{:MediaWiki:Revreview-completeness‎-4}}
-| Complete
+| {{:MediaWiki:Revreview-completeness‎-5}}
 |---
-| Clarity
+| {{:MediaWiki:Revreview-clarity‎}}
-| Unreviewed
+| {{:MediaWiki:Revreview-clarity‎-0}}
-| Unclear
+| {{:MediaWiki:Revreview-clarity‎-1}}
-| Widespread clarity problems
+| {{:MediaWiki:Revreview-clarity‎-2}}
-|style="background: #CDCDCD"| Somewhat clear
+|style="background: #CDCDCD"| {{:MediaWiki:Revreview-clarity‎-3}}
-| Almost clear
+| {{:MediaWiki:Revreview-clarity‎-4}}
-| Totally clear
+| {{:MediaWiki:Revreview-clarity‎-5}}
 |}
@@ Line 114: / Line 114: @@
 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.
-[[Category:KB2Wiki]]
+== Strings ==
+These are string resources used by the Flagged Revs extension.  Because they are in the "Mediawiki:" namespace, only administrators can edit them.
+* [[MediaWiki:Revreview-accuracy]]
+** [[MediaWiki:Revreview-accuracy-0]]
+** [[MediaWiki:Revreview-accuracy-1]]
+** [[MediaWiki:Revreview-accuracy-2]]
+** [[MediaWiki:Revreview-accuracy-3]]
+** [[MediaWiki:Revreview-accuracy-4]]
+** [[MediaWiki:Revreview-accuracy-5]]
+* [[MediaWiki:Revreview-completeness‎]]
+** [[MediaWiki:Revreview-completeness-0‎]]
+** [[MediaWiki:Revreview-completeness-1‎]]
+** [[MediaWiki:Revreview-completeness-2]]
+** [[MediaWiki:Revreview-completeness-3]]
+** [[MediaWiki:Revreview-completeness-4]]
+** [[MediaWiki:Revreview-completeness-5]]
+* [[MediaWiki:Revreview-clarity‎]]
+** [[MediaWiki:Revreview-clarity‎-0]]
+** [[MediaWiki:Revreview-clarity‎-1]]
+** [[MediaWiki:Revreview-clarity‎-2]]
+** [[MediaWiki:Revreview-clarity‎-3]]
+** [[MediaWiki:Revreview-clarity‎-4]]
+** [[MediaWiki:Revreview-clarity‎-5]]
+=== New namespace strings ===
+* [[MediaWiki:Hf-nsheader-Linden Lab Official]]
+* [[MediaWiki:Hf-nsfooter-Linden Lab Official]]
+[[Category:Wiki]]