Aufbau eines Howto¶

Ein Howto sollte aufgrund einer besseren Verständlichkeit die folgenden Gliederung benutzen:

1. Getestet mit – Angabe der verwendeten Ubuntu-Version mit Datum des letzten Tests.

2. Einleitung – Hier wird das Problem beschrieben, welches mithilfe des Howtos gelöst werden soll.

3. Anleitung – Die einzelnen Schritte, wie das Problem gelöst werden kann.

4. Linksammlung – Links zum zugehörigen Wikiartikel, falls es einen gibt, und/oder zu weiterführenden Internetseiten.

Gestaltung des Howtos¶

• Da es sich bei ubuntuusers.de um ein deutschsprachiges Portal handelt, sind Howtos in korrekter deutscher Sprache zu verfassen.

• Direkte Anrede (z.B. „Danach machst du ...“) ist zu vermeiden. Stattdessen soll das neutrale „man“ (z.B. „Danach macht man ...“) verwendet werden, da so die Sachlichkeit des Artikels besser zur Geltung kommt.

• Auf umgangssprachliche Ausdrücke (z.B. „Jetzt läuft das System total rund und alles ist easy going.“) sollte verzichtet und stattdessen eine sachliche Formulierung gewählt werden (z.B. „Jetzt läuft das System völlig problemlos.“). Dies erhöht die Lesbarkeit eines Howtos deutlich.

• Die vollständigen Syntaxregeln des Wikis müssen nicht beachtet werden, aber es macht das Lesen oft einfacher, wenn man zumindest einige Formatierungselemente nutzt. Besonders die Verwendung von Codeboxen zur korrekten Formatierung von Codebeispielen und -ausgaben wird empfohlen.

Zusätzlich sei noch auf den Abschnitt Nicht gestattete Inhalte weiter unten verwiesen, der einige häufige Fehler bei der Erstellung eines Howtos aufführt.

Lizenzbedingungen¶

• Mit dem Speichern des Howtos erklärst du dich mit den Portalregeln und der Veröffentlichung deines Howtos unter den aktuell gültigen Lizenzbedingungen des Wikis einverstanden.

• Du bestätigst mit dem Speichern außerdem, dass du das Howto selbst erstellt hast und es nicht von einer anderen Quelle kopiert hast.

• Das Wikiteam behält sich die Nicht-Veröffentlichung der Howtos vor, z.B. dann, wenn die oben aufgeführten, minimalen Gestaltungsregeln nicht eingehalten werden. Ebenso behält sich das Wikiteam das Entfernen von Howtos vor, z.B. wenn sich in der zugehörigen Diskussion herausstellt, dass der Inhalt fehlerhaft oder gar schädlich ist.

Howto veröffentlichen¶

Möchtest du ein Howto veröffentlichen, dann eröffne mit einem Klick auf „Diskussion“ (oben in der Menüleiste) ein neues Thema und kündige an, dass dein Howto fertig ist. Das Wikiteam überprüft daraufhin, ob die wenigen formalen Punkte erfüllt sind. Eine inhaltliche Prüfung findet nicht statt. Nach einer erfolgreichen Prüfung verschiebt das Wikiteam das Howto in die Howto-Sammlung und ergänzt einen Eintrag auf dieser Übersichtseite.

Des Weiteren können (seit 3.5.2015, gem. eines internem Beschluss des Wikiteams), Howtos vom Wiki aus verlinkt werden. Der Link auf das Howto kann in einem passendem Wikiartikel im Abschnitt "Links" aufgenommen werden.