Der Thread soll Leuten helfen die noch kein Gefühl dafür haben, wie sie ihre Wiki Artikel formatieren sollen, beziehungsweise was die Artikel beinhalten sollen.


Funktionsbeschreibungen
Die einfachste Artikel sind Funktionsbeschreibungen. Wieso? Alles ist vorbestimmt:
- Die Formatierung soll (MUSS!!!) sich an der Formatvorlage orientieren.
- Der Inhalt soll sich möglichst genau an den orginal Beschreibungen orientieren die man im Netz findet (Also Übersetzen ist gefragt). Die MSDN geht hin und wieder Sonderwege. Deshalb erstmal alle Infos aus den Dokumenten von z.B. SGI hohlen (oder über Google den Funktionsnamen eingeben -> min 5 verschiedene Quellen mit den engl. Spez.) und dann mal bei MSDN gucken ob die noch mehr haben.
Wenn aus all den Quellen das Wissen ausgesaugt wurde könnt ihr persönliche Erfahrungen/Hinweise die allgemeingültig sind/sein könnten in den Artikel aufnehmen.

Extensionbeschreibungen
Etwas komplizierter (weil die Texte länger und Fachspezifischer sind) sind die Extensiondokus. Hier gilt:
- Die Formatierung soll (MUSS!!!) sich an der Formatvorlage für Extensions orientieren. Da Erfahrungen hier noch rar sind, muss sich noch zeigen, ob mehr Unterpunkte in die Vorlage aufgenommen werden sollen. Das Grundgerüst soll aber schon so sein wie angegeben.
- Der Inhalt soll sich möglichst genau an den orginal Beschreibungen orientieren die man im Netz findet (Also Übersetzen ist gefragt). Links zu den Quellen sind unter "Extensions" im Wiki angegeben.

Allg. Artikel, Hintergrundwissen
Rein vom kreativen Teil sind die Artikel am Kompliziertesten. Gut ist, dass euch niemand den Artikel vorschreibt. Doch auch hier gilt:
- Gliedert den Artikel. Dadurch wird der Artikel leichter lesbar und wahrscheinlich auch eher gelesen. Durch verschiendene Überschriften erstellt das Wiki außerdem selbstständig ein Inhaltsverzeichnis.
- An den Anfang des Artikels gehört ein kurzer Abriss des Inhalts. Ein Leser soll nach dem ersten Abschnitt wissen von was der Artikel handelt. Wenn es ihn dann interessiert, könnt ihr ihn im Weiter mit eurem Wissen zuschütten.
- Der Inhalt umfasst alles, was euch zum Thema einfällt. Sollte es soviel werden, dass der Artikel mehr als 2-3 Bildschirmseiten überschreitet, kann es lohnend sein Teile des Artikels in Subartikel auszulagern. (siehe z.B. Billboard Artikel)
- Vermeidet Sackgassen. Man soll möglichst in jedem Text Links zu weiteren Artikeln finden.


Allgemeine Hinweise
- Verwendet Bilder! OpenGL ist fürs Auge gemacht und sollte deshalb schon bei der Lernphase dem User das Wasser im Mund zusammenlaufen lassen. (Ein Screenshot ist leicht gemacht.)
- Wenn ihr meint euer Artikel ist noch nicht fertig (es fehlt was, oder Teile müssen noch übersetzt werden) dann markiert den Artikel indem ihr in die erste Zeile den Hinweis: {{Unvollständig}} schreibt. Anschließend bitte den Artikel speichern und auf den Link "weitere Unvollständige Artikel" klicken und den eigenen Artikel dort in die Tabelle eintragen. (Damit wird er leichter von anderen Wikischreibern gefunden)
- Wenn bei Übersetzungen Teile vorerst nicht übersetzt werden konnten sollten die fehlenden Teile ins Wiki kopiert werden (den orginaltext) und dann markiert werden mit <b><i>der orginale Text</i></b>. Die Formatierung kann trotzdem schon gemacht werden (einrücken etc.) Dadurch sind andere Nutzer schneller in der Lage fehlende Teile "mal zwischendurch" zu übersetzen.
- Jeder der Wiki schreiben will sollte sich mal die Formatierungsmöglichkeiten angeguckt haben. (Wikicode ist net halb so "schwer" wie Delphi )


Den ganzen Text hätte man auch in ähnlicher Form im Wiki finden können. Also guckt mal hier und schreibt was schönes (ins Wiki!).

_________________
Blog: kevin-fleischer.de und fbaingermany.com