Hilfe:Flagged Revisions

Aus HL7 Austria MediaWiki
Wechseln zu: Navigation, Suche

Die Extension Flagged Revision ermöglicht es Benutzern der Gruppe Editor (also Bearbeiter) und Reviewer (also Sichter) Versionen von Artikeln zu bewerten und diese Versionen als Standardversion auf eine normale Ansicht zu setzen. Diese Versionen werden die gleichen bleiben, auch wenn eingebundene Vorlagen geändert oder Bilder überschrieben werden.

Damit soll primär das Problem der verändernden Templates in Art-Decor gelöst werden. Mit Flagged Revision stellen wir die Versionierung der Leitfäden sicher.

Die Extension Flagged Revisions unterliegt einigen Änderungen, da sie für unsere Zwecke angepasst wurde.

1 Current vs. Stable Version

Im Flagged Revision gibt es zwei verschiedene Versionen von Seiten. Die current Version ist die Version der Seite, die den angemeldeten Benutzern als erstes angezeigt wird. Die stable Version ist die Version der Seite, die den nicht angemeldeten Benutzern als erstes angezeigt wird. Durch wechseln der Reiter "Lesen" und "Revision" kann zwischen Stable und Current Version gewechselt werden. "Lesen" steht für die Stable Version, "Revision" steht für die Current Version.

In der Current Version werden alle Änderungen eines Leitfadens vorgenommen, während in der Stable Version die alte Version des Leitfadens angezeigt wird. Die Stable Version wurde zu Beginn der Editierung als "Abgenommen" geflaggt. Damit wird sichergestellt, dass alle Änderungen von nun an in die Current Version einfließen. Beim Flaggen "Bearbeitung abgeschlossen" und "Geprüft" bleiben die Änderungen in der Current Version. Erst beim Flaggen auf "Abgenommen" wandert die Current Version in die Stable Version.

2 Status

Es gibt vier verschiedene Status, die folgende Funktionen haben:

  • in Bearbeitung: ist derzeit nicht möglich zu verwenden, da der Button zur Bestätigung ausgegraut wird (Grundeinstellung von FlaggedRevs)
  • Bearbeitung abgeschlossen: wird geflaggt, um anzugeben, dass der Beitrag abgeschlossen ist. Beitrag bleibt in der Current Version
  • Geprüft: wird geflaggt, um anzugeben, dass der Beitrag geprüft worden ist. Beitrag bleibt in der Current Version
  • Abgeschlossen: wird geflaggt, um anzugeben, dass der Beitrag/Leitfaden abgeschlossen ist. Current Version wandert in Stable Version und ist für alle sichtbar

3 Benutzergruppen

Es gibt drei verschiedene Benutzergruppen, die folgendes flaggen können:

  • Passive Sichter (Autoreview): wird bei uns nicht verwendet
  • Sichter (Editor ):
    • Bearbeitung abgeschlossen
  • Prüfer (Reviewer):
    • Bearbeitung abgeschlossen
    • Geprüft
    • Abgenommen

4 Prozess zur Versionierung von CDA Leitfäden im Wiki

Es gibt 3 verschiedene Varianten:

5 Versionsvergleich

TestseiteFlagged

6 Probleme, Lösungen und Anpassungen

6.1 Problem mit Einbinden der Erweiterung

Wir hatten große Probleme die Erweiterung einfach einzubinden. Wir mussten zuvor das Wiki auf die Version 1.30 updaten, um die neueste stabile Version von Flagged Revisions (1.30) einbinden zu können (Stand Mai 2018). Unsere Wikiversion zuvor lag bei 1.27, nur leider schlug das Einbinden der Version 1.27 und 1.30 der Flagged Revisions fehl. Daher sahen wir uns gezwungen unser ganzes Wiki upzudaten. Nach erfolgreichen Update war es möglich die Extension Flagged Revisions 1.30 einfach einzubinden.

6.2 Anpassungen

6.2.1 Auswirkungen von Flaggen

Unser Workflow sieht vor, dass erst beim flaggen einer Seite auf die höchste Qualität("abgenommen") die Änderungen in die Stable Version gezogen werden. Beim Flaggen von niedrigeren Qualitätsstatus ("Bearbeitung abgeschlossen" und "Geprüft") sollen die Änderungen in der curretn Version bleiben. Damit das Flaggen der verschiedenen Status verschiedene Auswirkungen auf die current und stable Versionen der Seiten haben, musste folgende Anpassung gemacht werden.

Verzeichnis FlaggedRevs/backend/FlaggedRevisions.php

public static function determineStable(
		Title $title, $flags = 0, $config = [], $precedence = 'pristine' #'latest' die Änderung bewirkt, dass nur beim höchsten Level die current Version in die stable Version gezogen wird
	)

6.2.2 Auto-review

Unser Workflow sieht es nicht vor, dass Änderungen, die durch einen Sichter oder Passiven Sichter gemacht werden, automatisch in die stabile Version geschoben werden. Auto-review sieht aber genau das vor, dass Änderungen automatisch ohne flaggen in die stabile Version gezogen werden. Daher stellten wir das auto-review in der FlaggedRev.php ab:

Verzeichnis: extension/FlaggedRevs/FlaggedRevs.php

$wgFlaggedRevsAutoReview = FR_AUTOREVIEW_NONE; 

6.2.3 Status

Die original Erweiterung sieht 12 verschiedene Status vor, da wir jedoch nur vier benötigen, wurden diese reduziert.

Verzeichnis: extension/FlaggedRevs/FlaggedRevs.php

$wgFlaggedRevsTags = [
	'accuracy' => [ 'levels' => 3, 'quality' => 3, 'pristine' => 4 ] ,
#	'depth'    => [ 'levels' => 3, 'quality' => 3, 'pristine' => 4 ], wurde auskommentiert
#	'style'    => [ 'levels' => 3, 'quality' => 3, 'pristine' => 4 ], wurde auskommentiert
];

6.2.4 Rechteverteilung

6.2.4.1 Prüfer

Der Prüfer kann bei uns alle Levels von Accurancy sehen.

Verzeichnis: extension/FlaggedRevs/FlaggedRevs.php

$wgFlaggedRevsTags = [
	'accuracy' => [ 'levels' => 3, 'quality' => 3, 'pristine' => 4 ] ,
#	'depth'    => [ 'levels' => 3, 'quality' => 3, 'pristine' => 4 ], wurde auskommentiert
#	'style'    => [ 'levels' => 3, 'quality' => 3, 'pristine' => 4 ], wurde auskommentiert
];

6.2.4.2 Sichter

Der Sichter kann nur das erste Level von Accurancy sehen, daher wurde folgende Änderung durchgeführt:

Verzeichnis: extension/FlaggedRevs/FlaggedRevs.php

$wgFlaggedRevsTagsRestrictions = [
	'accuracy' => [ 'review' => 1],
#	'depth'    => [ 'review' => 2],  wurde auskommentiert
#	'style'    => [ 'review' => 3], wurde auskommentiert
];

Weiters wurden die GroupPermissions für den Editor/Sichter angepasst:

Verzeichnis: extension/FlaggedRevs/FlaggedRevs.php

# Define our basic reviewer class of established editors (Editors)
$wgGroupPermissions['editor']['review']            = true;
$wgGroupPermissions['editor']['autoreview']        = false; #true;
$wgGroupPermissions['editor']['autoconfirmed']     = false; #true;
$wgGroupPermissions['editor']['editsemiprotected'] = false; #true;
$wgGroupPermissions['editor']['unreviewedpages']   = true;

6.2.4.3 Passiver Sichter

Da das auto-review bei uns nicht verwendet wird, hat der passive Sichter keine Verwendung und alle Rechte wurden auf false gesetzt.

Verzeichnis: extension/FlaggedRevs/FlaggedRevs.php

$wgFlaggedRevsTagsAuto = false;

6.2.5 Wording

Das Wording wurde bei uns ebenso angepasst. Der Reiter für die Änderungen wurde auf "Revision" geändert.

Ebenso wurde das Wording der Status angepasst "in Bearbeitung", "Bearbeitung abgeschlossen", "Geprüft", "Abgenommen".

Verzeichnis: FlaggedRevs/i18n/flaggedrevs/de.json

        "revreview-current": "Revision",
	"revreview-accuracy-0": "In Bearbeitung",
	"revreview-accuracy-1": "Bearbeitung abgeschlossen",
	"revreview-accuracy-2": "Geprüft",
	"revreview-accuracy-3": "Abgenommen",