|
Inhaltsverzeichnis
FormatierungskonventionenHier sollen Empfehlungen für die Formatierung der Dokumente in diesem Bereich des Wikis festgehalten werden. Mögliche Formatierungen können in der DokuWiki-Dokumentation nachgeschlagen werden. CodeCode-Beispiele sollten immer über die DokuWiki-Tags eingebunden werden: <code php> <?php // Code [...] </code> Analog für alle anderen Programmiersprachen. Soll kein Syntax-Highlighting aktiviert werden, kann als Sprache einfach 'text' übergeben werden. LinksLinks erhalten immer aussagekräftige Namen, 'hier' ist somit absolut inakzeptabel als Linkbeschreibung. Meta-InformationenIst eine Seite nicht mehr auf dem aktuellen Stand oder noch unvollständig, so sollte diese Zeile am Ende des Dokuments eingefügt werden: {{tag>code:veraltet}}
Zu bearbeitende Sektionen sollten mit dem Fixme-Smiley hervorgehoben werden. TextformatierungMit Textformatierungen muss nicht gespart werden, aber es sollte eine gewisse Konsequenz herrschen (wer einmal Pfadnamen in bestimmter Weise hervorgehoben hat, sollte dies z.B. auch beibehalten), bestimmte Vorgaben gibt es dabei allerdings nicht. Variablen, Pfade, Strings aus Codebeispielen könnten hervorgehoben werden. |