Aus PHP.de Wiki
Dies ist eine Sammlung von Vorschlägen, die ein einheitliches Erscheinungsbild des Wiki fördern sollen.
Es darf alles diskutiert werden, bin hier nicht der Bestimmer.
--n
Lesenswert: Wikipedia Linkhilfe
Namenskonventionen
Hier stehen Namenskonventionen (vergleichbar, aber sehr umfassendes Vorbild: [1]) zur Diskussion.
Schreibung von Sprach-Abkürzungen
- Acronyme und Abkürzungen durchgängig groß: PHP, XML, HTTP, aber auch typisch z.B. MySQL ...
Schreibung von Fachbegriffen
- Artikel unter dem mehr verbreiteten Namen veröffentlichen,
- Redirect auf Alternativnamen: Singelton vs. Einzelstück, Pattern vs. Entwurfsmuster, vgl. dazu folgenden Punkt
Sprache
- Wenn verbreitet ist der deutsche Terminus vorzuziehen. Ist der englische Begriff enger gefasst oder fachspezifischer als sein deutsches Pendant, ist dieser zu verwenden (Bspw. Request, Query, ...). In jedem Fall sind bei konkurrierenden Begrifflichkeiten Redirects notwendig.
- Wiki-Strukturen (Kategorien, Namespaces) möglichst ebenfalls in deutsch.
-
Englische Begriffe sind durchweg klein zu schreiben ???
Formatierungskonventionen
Semantik
- Der Begriff eines Wikiartikels sollte im ersten Absatz eingeführt und fett gekennzeichnet werden.
- Wikiverlinkungen sind beim ersten Auftauchen des Begriffs vorzunehmen. Ausnahme: Der Absatz enthält sehr viele Links, dann ist ein späterer Absatz vorzuziehen.
- Wichtige Begriffe können bereits verlinkt werden, wenn die entsprechenden Artikel noch nicht existieren. So ergibt sich ein Todo. Als generelles Vorgehen ist dies wohl nicht geeignet.
Stil
- Durchgängige Überschriftensystematik. Also == aufwärts (1er ist die Artikelüberschrift)
- Codebestandteile im Fließtext sind durch eine Nicht-Proportional-Schrift zu kennzeichnen.
- Fließtext in einheitlicher Farbe und Schriftart, Textbetonung durch kursive Schrift
