Howto

Inhaltsverzeichnis
  1. Was ist ein Howto?
  2. Vorhandene Howtos
  3. Howto erstellen
    1. Aufbau eines Howto
    2. Gestaltung des Howtos
    3. Lizenzbedingungen
    4. Howto veröffentlichen
  4. Howto anlegen
  5. Bearbeiten von Howtos
  6. Archivierung von Howtos
  7. Nicht gestattete Inhalte
  8. Links

Was ist ein Howto?

Ein Howto ist eine einfache Schritt-für-Schritt-Anleitung, welche von Nutzern für Nutzer erstellt wurde. Howtos können z.B. zur Unterstützung im Support verwendet werden, um schnelle Problemlösungen bereitzustellen oder auch z.B. komplexere Installationsszenarien von Programmen und Diensten Schritt für Schritt beschrieben . Sie sind daher nicht Teil des hiesigen Wikis, in dem für (neue) Artikel umfassendere Ansprüche gelten.

Achtung!

Bei Problemen mit einem Howto melde dies bitte in der dazugehörigen Diskussion und wende dich bitte zusätzlich an den Verfasser des Howtos. Die Anwendung erfolgt wie üblich auf eigene Gefahr.

Vorhandene Howtos

Vorhandene Howtos sind über ihre Schlagwort-Kennzeichnung (Tags) zu finden: Liste fertiger Howtos

Howto erstellen

Im Vergleich zu einem Wikiartikel muss ein Autor bei der Erstellung eines Howtos deutlich weniger Punkte beachten.

Aufbau eines Howto

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

  1. Howto Markierung – Angabe, wer das Howto erstellt hat

  2. getestet mit - es wird der selbe getestet-Block verwendet wie bei Wikiartikeln

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

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

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

  6. Tag: Howto - jedes Howto muss den den Tag "Howto" am Ende enthalten

Gestaltung des Howtos

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

Howto veröffentlichen

Möchtest du ein Howto veröffentlichen, dann eröffne mit einem Klick auf „Diskussion“ (rechts 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, Howtos vom Wiki aus an passenden Stellen verlinkt werden. Der Link auf das Howto kann in einem passendem Wikiartikel im Abschnitt "Links" aufgenommen werden.

Howto anlegen

Howtos müssen über die Seite Wikiartikel_anlegen erstellt werden. Bitte dem gewünschten Artikelnamen ein Howto/ voranstellen.

Ein neues Howto wird dann in der Baustelle angelegt. Vorlage/Howto zeigt die Struktur und die wichtigsten Elemente.

Bearbeiten von Howtos

Der Nutzer, der das Howto erstellt hat, sollte dieses natürlich auch langfristig pflegen und aktuell halten. Grundsätzlich dürfen Howtos aber, wie Wiki-Artikel auch, von jedem angemeldeten Benutzer bearbeitet, aktualisiert und erweitert werden. Nach dem Überarbeiten eines Howtos muss dieses erneut getestet werden, um im Howto-Bereich zu verbleiben.

Archivierung von Howtos

Howtos werden automatisch vom Wikiteam als „Veraltet“ markiert, wenn

  1. jede Ubuntuversion, für die das Howto getestet ist, das Supportende erreicht hat

  2. in der Diskussion ein Fehler gemeldet wurde und dieser nicht innerhalb von zwei Wochen korrigiert wird.

Veraltete Howtos werden nach weiteren zwei Monaten ins Archiv verschoben. Wird das Howto innerhalb dieser zwei Monate erfolgreich getestet, dann verbleibt das Howto in der Howto-Sammlung und der Hinweis „Veraltet“ wird entfernt.

Nicht gestattete Inhalte