Wiki-Nutzung

Das ITZkS-Wiki soll für jedermann schnell nachvollziehbar die wichtigen Informationen bereitstellen, die für die Administration der ITZKS-Schulinfrastruktur benötigt werden. Dazu ist es wichtig, dass die Inhaltserstellung nach festen Konventionen erfolgt. Im folgenden Abschnitt werden diese Konvetionen erläutert.

Neue Seiten anlegen

Im ITZKS-Wiki gibt es verschiedene Möglichkeiten neue Seiten anzulegen. In diesem Wiki werden keine CamelCase (SeiteUnterseite) Seitenstrukturen verwendet, sondern ausschliesslich Unterseiten ähnlich Namespaces (Seite/Unterseite) angelegt. Der einfachste Fall Unterseiten neu anzulegen ist, einen Link auf die neue Seite auf einer bestehenden Seite anzulegen. Die Konvention für interne Links:

[[Oberseite/Unterseite1/UnterUnterseite1|sprechender Linktext für Unterunterseite 1]

Nach Erstellung des Links und speichern der Änderungen, klickt man auf den Link und wählt im Folgefenster "Seite anlegen". Im dann erscheinenden Editorfenster den Seitentitel folgenderweise eintragen:

== Seitentitel Unterunterseite 1 ==

Textgliederung

Eine Dokumentation soll ermöglichen schnell die gebrauchte Information zu finden. Deshalb ist es sinnvoll Textblöcke in inhaltliche Einheiten zu zerlegen und durch Zwischenüberschriften zu beschreiben. In diesem Wiki (MoinMoin) stehen fünf Überschriftenbenen zur Verfügung (http://www.wikiwikiweb.de/HilfeZurMoinWikiSyntax#A.2BANw-berschriften).

Überschriften in diesem Wiki

Die fünfte Überschriftenebene ist jedoch kleiner als fett geschrieber Text. Sie ist somit nicht eindeutig als Gliederung zu erkennen. Daher verwenden wir nur Überschriftenebene 1-4

Listen

Für das Arbeiten mit Anleitungen hat sich gezeigt, dass man Listen mit bis zu 7 Unterpunkten gut abarbeiten kann. Längere Listen sind nicht so übersichtlich und erschweren damit das Auffinden der gesuchten Information. Wenn eine Liste von Arbeitsschritten mehr als 7 Unterpunkte aufweißt sollten Zwischenüberschriften eingefügt werden, die das Finden der Informationen erleichtern. Das gilt natürlich nicht sträflich. Wenn eine Liste nach 8 oder 9 Punkten abschlossen ist, muss man nicht extra für die 2 Punkte eine Zwischenüberschrift einfügen.

Fehler korrigieren / Verbesserungen einarbeiten

Oftmals ist es nicht möglich, Fehler oder Ungenauigkeiten im Wiki sofort zu beheben. Mal mangelt es an Zeit und Fokus, mal auch an Kenntnissen.

Dennoch sollten wir Passagen im Wiki, die eine Überarbeitung benötigen, immer sofort beim Auffinden des Mangels markieren. Später können wir die markierte Stelle dann entweder selbst überarbeiten bzw. von jemand anderem im Projekt überarbeiten lassen.

1. Fehler bzw. verbesserungsfähige Passage im Wiki finden

2. Passage mit dem Ausdruck FixMe markieren und ggf. einen kurzen Kommentar anfügen, warum wir denken, dass die Stelle überarbeitet werden muss

3. Später dann: FixMe-Markierungen im Wiki aufspüren über diese Seite: FixMe

4. Markierten Abschnitt bearbeiten und verbessern