Zur inoffiziellen Fedora FAQ beitragen

 


Ich freue mich über jeden Beitrag zur FAQ! Wenn du auch dazu beitragen möchtest, kannst du das auf zwei verschiedene Arten tun. Entweder sendest du mir den Text oder - noch besser - das vorformatierte HTML. (Unten auf der Seite findest du ein paar Richtlinien für HTML.)

Anmerkung: Ein weiterer guter Weg zu dieser FAQ beizutragen ist, sich in die Insider FAQ einzutragen. Das unterstützt einerseits die Arbeit an dieser FAQ und bringt dir andererseits eine Menge nützlicher Informationen!


Richtlinien


Hier findest du ein paar Richtlinien, die ich beim Schreiben der FAQ benutze. Es ist nicht schlimm, wenn dein Beitrag nicht alle davon erfüllt. Wir helfen weiter, wenn du uns eine E-Mail schreibst! Im Zweifel lies die FAQ und schau dort nach, wie die Fragen geschrieben sind.

Zweck der FAQ: Hilfestellung für alle Fedoranutzer beim Bewältigen der häufigsten Probleme.

  • Zielgruppe: Beim Schreiben der FAQ versuche ich mich in die Lage eines Lesers zu versetzen, der Linux zuvor noch nie benutzt hat, aber Fedora gern testen möchte. Auf diese Weise können sowohl neue Nutzer als auch bereits Erfahrenere diese FAQ als Informationsquelle nutzen.
  • Die Fragen sollten häufig gestellt werden. Für seltener gestellte Fragen ist das FedoraForum erste Anlaufstelle. Beispielsweise ist "Ich habe Probleme beim Installieren von Fedora auf meinem brandneuen Computer; was kann ich tun?" eine häfig gestellte Frage. Im Gegensatz dazu wird "Wie schreibe ich ein C++-Programm unter Fedora, dass meine Socken röstet?" deutlich seltener gestellt. Es ist ziemlich einfach, sich im FedoraForum umzusehen, ob andere die selbe Frage massenhaft stellen. Im Zweifel schick uns die Frage und wir schauen sie uns an, ob sie oft gestellt wird oder nicht.
  • Verständlichkeit: Ich versuche, die Antworten so einfach wie möglich zu halten. Das bedeutet, dass ich aus mehreren Antworten auf eine Frage die für einen Einsteiger am besten nachvollziehbare auswähle. Das ist aber manchmal nicht die beste, funktioniert aber immer! Beispielsweise benutze ich in der FAQ yum statt apt, weil yum automatisch von Fedora installiert wird, apt aber einen zusätzlichen Download bedeutet: Mehr Komplexität.
    Das bedeutet auch, dass ich keine Worte benutze, die neue Nutzer nicht wissen. Wenn ich es dennoch tun muss, erkläre ich sie vorher.
  • Kürze: Die FAQ sollten möglichst kurz sein. Ich bin der Meinung, dass ein Neuling die ganze FAQ während einer Sitzung lesen können sollte. Sätze, die nicht unbedingt notwendig sind, streiche ich lieber.
  • Fedora-spezifisch: Üblicherweise werden in den FAQ Fedora-spezifische Fragen beantwortet. Im Internet gibt es genügend Seiten zu Linux allgemein. Wenn du dennoch etwas zu Linux allgemein beitragen willst, was auch für Fedora-Nutzer interessant und wichtig ist, sind die Fedora Basics die richtige Anlaufstelle.
  • Klarheit: Vielen Lesern stehen die FAQ nicht in ihrer Muttersprache zur Verfügung. Daher versuche ich die Fragen und Antworten so klar wie möglich zu formulieren und komplexe Wörter zu vermeiden.

HTML-Richtlinien


Wenn du deine Beiträge direkt in HTML einsendest, würde mich das wirklich freuen! Hier findest du ein paar Richtlinien, die ich für die FAQ verwende. Wenn du nicht alle davon erfüllen kannst, schreib mir eine E-Mail und ich schaue, was ich tun kann.

  • Einfache XHTML-Struktur: Alle Fragen haben die gleiche Struktur. Wenn du HTML einsenden möchtest (was uns sehr freut!), nimm einfach eine Frage aus den FAQ und ersetze den vorhandenen Text durch deinen. Die Seiten werden als XHTML 1.0 Strict geprüft.
  • Durchgängiger Stil: Das wird mit XHTML (siehe voriger Punkt) und durch mein CSS sichergestellt. Wenn du noch nicht allzu viel über CSS weißt, ist das nicht schlimm. Nimm einfach ein passendes Stück Quellcode aus der FAQ und ersetz den Originaltext durch deinen.
  • Verändere Links nicht: Es gibt Hunderte (wenn nicht Tausende) Links zu dieser FAQ oder den jeweiligen Übersetzungen und keiner sollte jemals einen "404: Seite nicht gefunden"-Fehler zurückliefern. Auch die Anker (der Teil hinter dem "#"-Zeichen) sollten immer funktionieren. Das bedeutet, dass du jedes Mal beim Ändern eines Ankers eine Kopie mit dessen alter Bezeichnung an dieser Stelle belassen solltest. Schau dir dazu auch Cool URIs don't change (geschrieben vom Erfinder von HTML und WWW) an, wenn du wissen willst, warum wir das tun.