Hilfe:Flagged Revisions

Aus HL7 Austria MediaWiki
Wechseln zu: Navigation, Suche

Die Extension Flagged Revision ermöglicht es von einer Seite zwei Versionen zu sehen. Die "Lesen" Version wird gleich bleiben, auch wenn eingebundene Vorlagen sich ändern oder Bilder überschrieben werden.

Damit soll primär das Problem der dynamischen Änderungen von Templates in Art-Decor gelöst werden. Ebenso stellen wir mit Flagged Revision die Versionierung der Leitfäden sicher.

Die Extension Flagged Revisions unterliegt einigen von uns durchgeführten Anpassungen.

1 Allgemeines

1.1 Lesen vs. Revision

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

Kurzbeschreibung Workflow:

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

1.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

1.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

1.4 Standardrechteverteilung

Unsere Standardrechteverteilung:

  • Sichter: für Mitarbeiter, die Änderungen am Wiki durchführen
  • Prüfer: Für Mitarbeiter, die Leitfäden freigeben

1.5 Versionsvergleich

TestseiteFlagged

1.6 Benutzung von Flagged Revisions

2 Probleme, Lösungen und Anpassungen

2.1 Einbindung von Flagged Revisions

Wir hatten große Probleme die Erweiterung einzubinden. Wir mussten zuvor das Wiki auf die Version 1.30 updaten, um die neueste und 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 wurde das gesamte Wiki upgedated. Nach erfolgreichen Update war es möglich die Extension Flagged Revisions 1.30 einzubinden.

2.2 Anpassungen

2.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
	)

2.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; 

2.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
];

2.2.4 Rechteverteilung

2.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
];

2.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;

2.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;

2.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",