Wiki-Gestaltung: Unterschied zwischen den Versionen

Aus TraiNexWiki
Wechseln zu:Navigation, Suche
(Schreib-Regeln für das Wiki)
(Schreib-Regeln für das Wiki)
Zeile 53: Zeile 53:
 
# Wir verwenden Absätze, Überschriften, Bilder und bei längeren Absätzen Spiegelstriche, um den Artikel übersichtlich zu gestalten.
 
# Wir verwenden Absätze, Überschriften, Bilder und bei längeren Absätzen Spiegelstriche, um den Artikel übersichtlich zu gestalten.
 
# 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".  
 
# 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".  
# Bilder werden durchnummeriert. Im Bild wird markiert, welcher Bereich erklärt wird, z.B. mit einem gelben Rahmen. Im Text wird Bezug genommen auf die Abbildung mit "(siehe Abb.3)".  
+
# Bilder werden durchnummeriert. Im Bild wird markiert, welcher Bereich erklärt wird, z.B. mit einem gelben Rahmen. Im Text wird Bezug genommen auf die Abbildung mit "(siehe Abb.3)". Bilder sollen ebenfalls ein sinnvolles Beispiel sein, also statt nicht ausgefüllt sein mit "test" oder "123" oder "xyz" sondern einem konkreten nachvollziehbaren einfachem Beispiel.
 
# Wir verwenden ein Gestaltungsraster, ein Struktur-Raster und diese Schreib-Regeln.
 
# Wir verwenden ein Gestaltungsraster, ein Struktur-Raster und diese Schreib-Regeln.

Version vom 13. Oktober 2021, 10:27 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
  • Didaktische Anregungen: falls es in der Lehre eingesetzt werden, z.B. bei Foren, MC-Tests
  • Videos, Aufsätze und sonstige Infos
  • Bekannte Probleme
  • Häufig gestellte Fragen (FAQ)
  • Letzte funktionelle Änderungen
  • siehe auch: Verweise auf andere Wiki-Artikel

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 Bildelement, z.B. dem Snip eines TraiNex-Formulars, soll nicht ein leeres Formular dargestellt werden, sondern immer sinnige Textbeispiele aufgenommen werden
  • Grafiken sind ggf. systematische Pfeildiagramme oder sonstige erklärende Systematisierungen

Gendergerechte Sprache

Im Wiki wird möglichst gendergerecht, aber trotzdem kurz und eindeutig, geschrieben. Wir verwenden neutrale Begriffe wie "Mitarbeitende" statt "Mitarbeiter/Mitarbeiterin" oder substantivierte Partizipativformen. Wenn aus Gründen der besseren Lesbarkeit das generische Maskulinum verwendet werden sollte, dann sind weibliche und anderweitige Geschlechteridentitäten ausdrücklich mitgemeint, soweit es für die Aussage erforderlich ist. Mehr unter Gender.

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. Faustregel: Nur maximal ein Nebensatz.
  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. Immer nur das beschreiben, worum es in dem Artikel geht. Angrenzende Themenbereiche nicht nochmals neu beschreiben sondern nur mit einem Link im Text erwähnen.
  5. 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 …“
  6. Wir benutzen „können (optional)“ oder „sollten“ oder „müssen (zwingend)“. Oder Formulierungen wie „Tragen Sie im Feld ‚Startdatum’ das Beginndatum des Events ein’.
  7. Rechtschreibung, Grammatik und Zeichensetzung müssen stimmen.
  8. Aktiv ist besser als passiv. Verben sind besser als Substantive. (Statt „Die Verwendung ist anzuraten“ besser “Am besten verwenden Sie …“)
  9. Alte Artikel nicht einfach neu schreiben. Alte Artikel sind bereits durchdacht und sollten nur erweitert oder vorsichtig korrigiert/strukturiert werden.
  10. Vor einer Text-Erweiterung den kompletten Artikel lesen und verstehen. Nach einer Erweiterung nochmals die Text-Erweiterung lesen.
  11. Wir verwenden Absätze, Überschriften, Bilder und bei längeren Absätzen Spiegelstriche, um den Artikel übersichtlich zu gestalten.
  12. 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".
  13. Bilder werden durchnummeriert. Im Bild wird markiert, welcher Bereich erklärt wird, z.B. mit einem gelben Rahmen. Im Text wird Bezug genommen auf die Abbildung mit "(siehe Abb.3)". Bilder sollen ebenfalls ein sinnvolles Beispiel sein, also statt nicht ausgefüllt sein mit "test" oder "123" oder "xyz" sondern einem konkreten nachvollziehbaren einfachem Beispiel.
  14. Wir verwenden ein Gestaltungsraster, ein Struktur-Raster und diese Schreib-Regeln.