ubuntuusers.de

Du betrachtest eine alte Revision dieser Wikiseite.

Howto

Hinweis:

Das Projekt „Howtos auf ubuntuusers.de“ befindet sich in einer sechsmonatigen Testphase, die vom 15.11.2014 bis zum 15. Mai 2015 dauert. Danach wird im Wikiteam – basierend auf der gesammelten Erfahrung, dem Feedback der Nutzer und Feedback aus dem Team von ubuntuusers.de – entschieden, ob und wie das Projekt fortgesetzt wird.

Was ist ein Howto?

Ein Howto ist eine einfache Schritt-für-Schritt-Anleitung, welche von Nutzern für Nutzer erstellt wurde und in erster Linie im Forum verwendet wird, um schnelle Problemlösungen bereitzustellen. Sie sind daher nicht Teil des hiesigen Wikis, in dem für neue Artikel weitaus komplexere 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

Seiten mit Tag „Howto“

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. 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 Schritt-für-Schritt Anleitung, 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 neutral „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.

Howto anlegen

Einfach das Wort Name durch den gewünschten Namen des Howtos ersetzen und mit oder Linksklick linke Maustaste auf „Seite erstellen“ bestätigen. Dann wird ein neues Howto automatisch unter Baustelle/Howto/Name angelegt.

Ist man sich beim endgültigen Namen nicht sicher bzw. möchte ihn später noch abändern, wird das vom Wikiteam übernommen (einfach fragen).

Neues Howto anlegen
Name Vorlage

Fehlendes Makro

Das Makro „NeueSeite“ konnte nicht gefunden werden.

Zum Erstellen eines Howtos: Die wichtigsten Elemente sind bereits vorhanden (Beispiel: Vorlage/Howto).

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. der letzte erfolgreiche Test des Howtos mehr als zwölf Monate zurück liegt oder

  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.

Darüber hinaus werden alle bis zum 15.05.2015 erstellten Howtos archiviert, wenn das Projekt nicht fortgesetzt werden sollte.

Nicht gestattete Inhalte

  • Howtos sind vor allem für das Forum als Supporthilfe gedacht und nicht als Erweiterung des Wikis. Howto-Anleitungen dürfen daher nicht in normalen Wiki-Artikeln verlinkt werden.

  • Es dürfen außer dem Tag # tags: Howto in der letzten Zeile des Howtos keine weiteren Tags in Howto-Anleitungen verwendet werden.

  • Kurzadressen (URL-Shortener) sind nicht gestattet. Das Gleiche betrifft auch Links zu kommerziellen Online-Shops und ähnlichen Seiten („Schleichwerbung“).

Diese Revision wurde am 17. November 2014 11:01 von aasche erstellt.
Die folgenden Schlagworte wurden dem Artikel zugewiesen: Howto