Wiki-Gestaltung: Unterschied zwischen den Versionen

Aus TraiNexWiki
Wechseln zu:Navigation, Suche
(Pflicht-Elemente)
(Bedarfs-Elemente)
Zeile 19: Zeile 19:
 
* Profi-Tipps = Kurze Praxis-Ratschläge zur Nutzung der Funktion
 
* Profi-Tipps = Kurze Praxis-Ratschläge zur Nutzung der Funktion
 
* Videos und sonstige Infos
 
* Videos und sonstige Infos
 +
* Bekannte Probleme
 
* Häufig gestellte Fragen (FAQ)
 
* Häufig gestellte Fragen (FAQ)
 
* siehe auch
 
* siehe auch

Version vom 18. August 2016, 10:29 Uhr

Auf dieser Seite werden alle internen Gestaltungsregeln für das TraiNex-Wiki gesammelt.

Strukturraster

Alle neuen Wiki-Einträge sollten nach dem folgenden Muster aufgebaut sein.

Pflicht-Elemente

  • Allgemeines = Kurzer Überblick über die beschriebene Funktion in einem Satz, inkl. Position = Wie gelange ich zu der Funktion innerhalb von TraiNex.

(Beispiel: Unter Admin//Anmeldung findet sich die Funktion zur Erstellung und Verwaltung von Anmeldung, Bestellungen und Bestätigungen.)

  • Nutzen = Kurze Zusammenfassung, was diese Funktion der Bildungseinrichtung bringt
  • Aufbau und Funktionen = Kurze und knappe Beschreibung der Benutzeroberfläche der jeweiligen Funktion sowie Beschreibung aller Aspekte, was man mit der Funktion machen kann

Bedarfs-Elemente

  • Sonderfunktion: falls es Spezialrechte auf der Seite gibt, die irgendwie zu beachten/vergeben sind, siehe auch Sonderfunktion
  • Textbausteine: falls es Textbausteine gibt, siehe auch Textbaustein
  • Konfigurationsparameter: falls es Schalter gibt, die TRON umstellen kann, siehe auch Konfiguration
  • Profi-Tipps = Kurze Praxis-Ratschläge zur Nutzung der Funktion
  • Videos und sonstige Infos
  • Bekannte Probleme
  • Häufig gestellte Fragen (FAQ)
  • siehe auch

Bildschirmfotos/Grafiken

  • Bildschirmfotos oder Grafiken sind Bildelemente
  • Bildelemente sollten zur Unterstützung der Erklärung angefertigt werden
  • möglichst direkt in einer Auflösung snippen, die anschließend wiki-tauglich ist
  • Gestaltungsraster: Bildelemente werden rechtsbündig eingebunden. Große Bildelemente haben eine Bildunterschrift. Kleine Bildelemente dürfen auch im Text integriert sein.
  • in dem Bildelement kann mit Markierungen auf wichtige Bereiche hingewiesen werden
  • bei Bildschirmfotos ggf. datenschutzrelevante Teile schwärzen
  • im Bildelemente, z.B. dem Snip eines TraiNex-Formulares, soll nicht ein leeres Formular dargestellt werden sondern immer sinnige Textbeispiele aufgenommen werden
  • Grafiken sind ggf. systematische Pfeildiagramme oder sonstige erklärende Systematisierungen

Schreib-Regeln für das Wiki

  1. An den Leser denken. Der Leser ist ein Mitarbeiter einer Hochschule, der ein TraiNex-Problem hat. Wir wollen dem Leser helfen, sein Problem zu lösen!
  2. Der Inhalt muss kurz und knapp, aber trotzdem eindeutig und verständlich zusammengefasst werden. Die Absätze sind weder zu lang noch zu kurz. Nur ein Gedanke pro Satz.
  3. Wir schreiben präzise, nicht umgangssprachlich und verwenden einheitliche Begriffe. TraiNex-Begriffe wie Feldnamen oder Buttons oder Module werden in Anführungszeichen gesetzt, um die Lesbarkeit zu erhöhen. Beispiel: das Feld „Verfalldatum“ oder der Button „Einstellen“.
  4. Den Leser ansprechen: Wir benutzen „Sie“ oder ausnahmsweise „man“, z.B. „In der Infozeile sollten Sie einen aussagekräftigen Betreff verwenden“ oder „Als Administrator sollten Sie …“
  5. Wir benutzen „können (optional)“ oder „sollten“ oder „müssen (zwingend)“. Oder Formulierungen wie „Tragen Sie im Feld ‚Startdatum’ das Beginndatum des Events ein’.
  6. Rechtschreibung, Grammatik und Zeichensetzung müssen stimmen.
  7. Aktiv ist besser als passiv. Verben sind besser als Substantive. (Statt „Die Verwendung ist anzuraten“ besser “Am besten verwenden Sie …“)
  8. Alte Artikel nicht einfach neu schreiben. Alte Artikel sind bereits durchdacht und sollten nur erweitert oder vorsichtig korrigiert/strukturiert werden.
  9. Wir verwenden Absätze, Überschriften, Bilder und bei längeren Absätzen Spiegelstriche, um den Artikel übersichtlich zu gestalten.
  10. Wir erklären erst allgemein und dann anhand eines konkreten Beispiels. Das Beispiel soll kurz, einfach und anschaulich verständlich sein. Das Beispiel soll positiv und eher zeitlos (ohne Jahresnennung) sein. Beispiel: "Exkursion zur Gartenmesse in Mailand im April" anstatt "Exkursion zur CeBIX-Innovation-Messe in Posemuckel am 21.3.2012 um 9 Uhr".
  11. Wir verwenden ein Gestaltungsraster, ein Struktur-Raster und diese Schreib-Regeln.