Um eine Vereinheitlichung des Layouts bei der ASV-Dokumentation zu erreichen, werden folgend die Vorgaben beschrieben, wie sie in der ASV Einführung umgesetzt worden sind.
Allgemeine Hinweise zum Erstellen und Bearbeiten einer Seite finden Sie in der Wikihilfe.

• Keine Beschreibung von Trivialitäten, wie etwa ein Bild des Diskettensymbols.
• Die Beschreibung der (Meta-)Aktion, die den Vorgang erläutert, ist einer einfachen Handlungsoption stets vorzuziehen.
  Beispiel: „Um eine neue Sammeländerung zu definieren, klicken Sie auf die Schaltfläche Neuen Datensatz hinzufügen.“
• Keine Wertungen in den Artikeln.
• Als Ergänzung kann bei jeder erstellten Seite ein Verweis angegeben werden, mit welcher ASV-Version dieser Eintrag erstellt worden ist.

• Keine unnötigen Abkürzungen:
  Beispiel: etc. oder usw. können bleiben, eine Abkürzung wie städt. für städtisch muss nicht sein.
• Aktiv dem Passiv bevorzugen.
• Zahlen zwischen eins und zwölf ausschreiben.
• Vermeidung von bzw., besser und / oder verwenden.
• Rechtschreibfehler, insbesondere Kommafehler sorgfältig aufspüren und entfernen.
• Klare, knappe Sätze, keine Schachtelungen.
• Korrekte Wortstellung beachten. Dazu gehört auch das Nachklappen von Verben:
  nicht: „Es empfiehlt sich die Bilder, deren Größe 10m*15m überschreitet, anzusehen.“
  besser: „Es empfiehlt sich die Bilder anzusehen, deren Größe 10m*15m überschreitet.“
• Keine bildliche oder kindliche Sprache:
  nicht: „Kann-Fehler: ASV ist der Meinung, dass hier ein Fehler vorliegt, der nicht zwingend korrigiert werden muss, aber einer gezielten Prüfung unterzogen werden sollte. Diese Fehler sind als Hinweise zu verstehen und entsprechend zu überprüfen. Kann-Fehler verhindern die Abgabe einer UP/US nicht.“
  besser: „Kann-Fehler: Die Prüfung entdeckt eine Dateneingabe, die auf einen möglichen Fehler hindeutet, einer gezielten Prüfung unterzogen werden sollte, aber aus technischer Sicht die UP/US nicht verhindert.“
• Schülerin bzw. Schüler anstelle nur der männlichen Form Schüler sowie Schülerinnen und Schüler im Plural.

• Überschriften:
  • Nützliche Hinweise bei der Erstellung von Überschriften erhalten Sie in der Syntax im Punkt 1.3 Überschriften.
  • Am Anfang eines Artikel steht immer eine Überschrift der Ebene 2. Auch Ebene 1 ist zulässig.
  • Bei einer weiteren Untergliederung werden Überschriften der Ebene 3 (blaue Schrift) verwendet.
  • Ein Inhaltsverzeichnis zur Seite ist nicht vorgesehen. In manchen Fällen bietet es sich aber an und kann eingeblendet werden.
  • Eine mögliche Anwendung der Überschriften sehen Sie in der Beispielseite.
• Bei der Verwendung von Links soll eine zielführende Bezeichnung gewählt werden.
  nicht: „Hier können Sie ausgewählte Datensätze prüfen, um vorhandene Fehler zu erkennen.“
  besser: „Um vorhandene Fehler zu erkennen, können Sie ausgewählte Datensätze prüfen.“
• Bei einer Aufzählung von mehreren, weiterführenden Links ist, so wie auf der Beispielseite, jeweils eine Kurzbeschreibung anzustreben.
• Befehle, Menüs und Reiter werden kursiv geschrieben. Variable Angaben werden mit spitzen Klammern geschrieben.
  z. B. Einsatz <Schuljahr>, Einsatz <SJ>, <Schulnummer Schulart>, <SNr. Schulart>
• Befehlsfolgen werden in Kurzform mit Freizeichen vor und nach dem Größerzeichen angegeben: Menü > Untermenü > Befehl.
• Tasten und Tastenkombinationen (z.B. STRG + UMSCHALT) in Versalschrift (nur Großbuchstaben).

• Sehr sparsame Verwendung.
• Höchstens zwei pro Seite.
• Linksbündige Orientierung.
• Ausschließlich verwendeter Wrap-Typ: „Info“
• Vorgegebene Breite: 85%
• Zur Anzeige werden abgerundete Ecken verwendet.
• Weitere Informationen erhalten Sie in der Wikihilfe bei der Verwendung des WRAP-Plugins.

<sortable 1>                                     ---Voreinstellung: Sortierung nach Spalte 1
|< 1000px 15% 10%>|                              ---Breite: 1000 px, 1. Spalte mit 15%, 2. Spalte mit 10%, 3. Spalte Rest
^ Spalte 1      ^ Spalte 2   ^ Spalte 3 ^ 
| abc    | def  | ghi    | 
| def    | ghi  | abc    | 
</sortable>

Beispiel: Fächerwahl

<WRAP centeralign>
<WRAP column 12%>[[berfoes/schueler/schueler_facherwahl|{{:alle:schulart_bers_berfoes_rund_aktiv.png?75|Berufliche Schulen & Berufliche Förderschulen}}]]</WRAP>   -----> Das ist die Zeile für die BerS mit aktivem Bild mit Link. Es muss immer entweder die 1. oder die zugehörige 2. Zeile verfügbar und die andere auskommentiert sein.
/*<WRAP column 12%>{{:alle:schulart_bers_berfoes_rund_inaktiv.png?75&nolink|Berufliche Schulen & Berufliche Förderschulen}}</WRAP>*/                               -----> Das ist die Zeile für die BerS mit inaktivem Bild ohne Link. Durch das Einklammern mit /* ... */ wird die Zeile auskommentiert. 
<WRAP column 12%>[[fosbos/us/schueler/faecherwahl|{{:alle:schulart_fosbos_rund_aktiv.png?75|Berufliche Oberschule}}]]  </WRAP> 
/*<WRAP column 12%>{{:alle:schulart_fosbos_rund_inaktiv.png?75&nolink|Berufliche Oberschule}} </WRAP>*/
/*<WRAP column 12%>[[Hier kommt ein Link rein|{{:alle:schulart_fws_rund_aktiv.png?75&nolink|}}]]</WRAP> */
<WRAP column 12%>{{:alle:schulart_fws_rund_inaktiv.png?75&nolink|}}</WRAP>
<WRAP column 12%>[[fz/schueler/schueler_facherwahl|{{:alle:schulart_fz_skr_rund_aktiv.png?75|Förderzentren & Schulen für Kranke}}]]</WRAP> 
/*<WRAP column 12%>{{:alle:schulart_fz_skr_rund_inaktiv.png?75&nolink|Förderzentren & Schulen für Kranke}}</WRAP> */ 
<WRAP column 12%>[[gms/schueler/schueler_facherwahl|{{:alle:schulart_gms_rund_aktiv.png?75|Grund- und Mittelschulen}}]]</WRAP>
/* <WRAP column 12%>{{:alle:schulart_gms_rund_inaktiv.png?75&nolink|Grund- und Mittelschulen}}</WRAP> */
<WRAP column 12%>[[gy/schueler/faecherwahl|{{:alle:schulart_gy_agy_kol_rund_aktiv.png?75|Gymnasien, Abendgymnasien & Kollegs}}]]</WRAP>
/*<WRAP column 12%>{{:alle:schulart_gy_agy_kol_rund_inaktiv.png?75&nolink|Gymnasien, Abendgymnasien & Kollegs}}</WRAP>*/
<WRAP column 12%>[[rs/us/faecherwahl_realschule|{{:alle:schulart_rs_ars_rsf_rund_aktiv.png?75|Realschulen, Abendrealschulen & Realschulen zur sonderpädagogischen Förderung}}]]</WRAP>
/*<WRAP column 12%>{{:alle:schulart_rs_ars_rsf_rund_inaktiv.png?75&nolink|Realschulen, Abendrealschulen & Realschulen zur sonderpädagogischen Förderung}}</WRAP>*/
</WRAP>

Der Beispielcode oben kann kopiert und an gewünschter Stelle eingefügt werden. Um einen aktiven Kreis zu einem inaktiven Kreis zu ändern muss in der entsprechenden Kombination, z.B. Bers Berfoes aktiv / inaktiv der aktive auskommentiert, also in

 /* ... */ 

gesetzt werden und beim inaktiven die entsprechende Kommentierung entfernt werden.

Bitte die Links aller aktiven Buttons prüfen und die Reihenfolge der Kreise von links nach rechts immer gleich lassen!

• Je nach Größe des Bildausschnitts ist eine möglichst einheitliche Breite der Screenshots auf einer Dokuseite anzustreben. Eine Breite von 1000 px bietet sich an.
• Screenshots immer linksbündig.
• Um unscharfe Screenshots zu vermeiden, ist ein Bild im Dateiformat *.png empfehlenswert.
• Vollbildschirm mindestens mit einer Auflösung von 1280*720.
• Keine Schwarzweiß-Screenshots.
• Keine VM-Screenshots.
• Keine Verwendung von anderen Zeichen wie Pfeilen oder händisches Markieren.
• Vor dem Screenshot muss unbedingt ein Zeilenende durch zwei Backslashes \\ angeben werden, sonst kann bei breiten Bildschirmen das Bild noch neben den Text „geklebt“ werden.
• Keine Screenshots, bei denen man nicht erkennt, wo sich der beschriebene Teil im ASV-Fenster befindet. Vielmehr sollen bedeutende Teile eines Screenshots durch einen roten Rahmen (#CC0000 in Linienstärke 3; ohne Schatten) hervorgehoben werden.
• Wenn mehrere Teile eines Screenshots beschrieben werden, können diese Bereiche mit Nummern gekennzeichnet werden.
• In der Beispielseite sehen Sie eine mögliche Umsetzung dieser Vorgaben.

Für die Erstellung der Screenshots gemäß den dargelegten Layoutbestimmungen ist es empfehlenswert, folgende externe Software zu verwenden:

Das Tool Greenshot ist hilfreich beim Abfotografieren bestimmter Bildschirmbereiche sowie für die Erstellung der Nummern.
Im Greenshot-Editor gibt es in der linken Leiste die Funktion Zähler hinzufügen.
Die Hintergrundfarbe stellen wir auf den Blauton #007FFF um. Der Durchmesser der Kreise wird nicht verändert.

Für einen Screenshot des vollen ASV-Bildschirms bei genau 1280*720 Pixel muss man ein entsprechendes Werkzeug verwenden.
Eine konkrete Möglichkeit ist das Werkzeug Sizer:
Hier lädt man sich einfach den neusten Entwicklungsordner (Sizer 3.4 Dev Build 482) herunter und extrahiert diesen. Das Werkzeug muss nicht installiert werden, sondern kann einfach durch das Klicken des sizer.exe -Files gestartet werden. Nach dem Start wird bei der Größenänderung eines Fenster seine momentane Große angezeigt. Ein Klick mit der rechten Maustaste auf das Maxi-/Minimieren-Symbol erlaubt es zudem, vorgegebene Bildschirmgrößen (in Pixel) auszuwählen.

Bildausschnitte bei vorgegebener Größe lassen sich mit dem Werkzeug Irfan-View vornehmen. Hierzu erstellt man zunächst einen Screenshot des kompletten Fenster (Alt-Drucken) und kopiert diesen einfach mit Strg-V in die IrfanView-Oberfläche. Dann wählt man unter Bearbeiten den Eintrag Spezielle Markierung erstellen. Dieser ermöglicht es, eine konkrete Größe vorzugeben, die dann durch einen entsprechenden Rahmen visualisiert wird. Bei gedrückter rechter Maustaste lässt sich dieser Rahmen dann verschieben und der gewünschte Teil mit Strg-X ausschneiden.