KissDoc:Leitlinien
Aus KissDoc
- Ein Artikel ist ein spezielles Thema wie DRBD, SSL, SSH, Win oder DOS und keine Kategorie.
- Auf dieser Artikel-Hauptseite sollte kurz auf Sinn und Zweck (Gründe und Ziele) eingegangen werden. Die eigentliche Dokumentationen sind Unterartikel des Artikels (z.Bsp. DOS:Netzwerk) und sollten von der Artikel-Hauptseite angelinkt werden.
- Die primären Quellen zu einem Thema sollten auf der Artikel-Hauptseite untergebracht werden (Überschrift Ressourcen). Dabei sollte mit externen Links sparsam umgegangen werden. Ein Link auf www ich-hab-was-rausbekommen dor de sit meist nicht Sinnvoll.
- Jeder Artikel sollte an seinem Ende einer oder mehrere Kategorien zugeordnet werden (nicht io).
- Auch sollte ein Artikel kein Sackgassenartikel werden.
- Sollte ein Artikel unfertig sein oder nur als unbrauchbares Fragment existieren, so ist oben auf der Page die Vorlage Draft
{{Draft}} zu verwenden.
- Alte Artikel, welche man nicht mehr selbst wartet und dafür keinen Nachfolger findet, werden mit der Vorlage Deprecated markiert oder eventuell auch gelöscht.
- Kategorien werden nur sehr sparsam angelegt. Kategorien sind ebenfalls zu Kategorisieren oder müssen im Inhaltsverzeichnis angegeben werden.
- HTML ist möglich und erlaubt, wobei derzeit möglichst nur
<code>, <pre>, <div> und nowiki Tags verwendet werden sollen.
- Urheberrechte beachten!
- Externe Links zu wilden Sites werden ohne Name bzw. Alias angegeben. Diese sind dann einfach am
[n] Format erkennbar. Prinzipiell sollten möglichst wenig solcher Links existieren.