Re: FAQ (war einst mal... Vom Umgang mit FAQs)
toRBEN pOLLmann
Was hat das damit zu tun? Wird dieses Argument nicht arg ueberstrapaziert? Meine Guete, nochmal zum Eigeninteresse: Ich selbst, und ich bin relativ neu hier, schreibe mir alles, was ich im System aendere, als kleine Kurzanleitung in Textfiles.
Das ist unpraktisch und fehlerträchtig. Außerdem macht es unnötig Arbeit. Folge: umsehen nach einer anderen Lösung. Lösung gefunden: CVS! Nachteil: diffs sind nicht sehr lesbar... Außerdem: nicht jede mal gemachte Änderung ist einfach so über ein simples Textfile nachzuvollziehen. So manche Änderung bedingt diverse andere Änderungen am System. Dann wird die Dokumentation dieser Änderungen länger als ein einfaches "tar -cvzf /misc/backup/servername-datum.tgz /etc". Zudem sind viele Änderungen "Umgebungsspezifisch". Es nutzt niemandem wenn ich ganz genau beschreibe, warum mein Server 10 IP-Adressen auf drei Netzweradaptern definiert hat, und die Routingtabelle sagenhafte 80 Einträge umfasst. Es würde auch anders funktionieren, nur möglicherweise nicht mit der gleichen Performance. Aber: diese Routingtabelle wird sinnlos, wenn ich den Server woanders aufstelle. Sie muß angepasst werden. Wie sie danach aussieht? Keine Ahnung. Folglich ist sie unbrauchbar für alle anderen. Zweites Beispiel: ein PC identisch ausgestattet zu einem anderen. Alles exakt gleich, auch Hardware und BIOS-Version. Auf PC1 funktioniert Sound mit ALSA, auf PC2 nicht. Warum? Weiß ich bis heute nicht. Aber es gab eine Alternative: die Kernel Sound-Treiber funktionierten. Ergebnis: beide PC konnten Krach machen. Nur eben auf eine vollständig unterschiedliche Weise. Fazit: solche "Gerätetagebücher" sind Gerätespezifisch. Sie können anderen Helfen, oder eben auch nicht. Es hängt sehr von den Randbedingungen ab, die beim Anderen gerade herrschen. Dann: die meisten Anfängerfragen zeigen eindeutig, das diese noch nie das Handbuch zu SuSE in die Hand genommen haben... Diese Leute wünschen Lösungen von mir. Schnell. Unkompliziert. Und umsonst. Besonders beliebt: liefer doch gleich das Konfig-File für meine Zwecke angepasst mit. Ich kopiere es gerne an den dafür vorgesehenen Platz! Aber ich behalte mir vor, unflätig zu werden, wenn es nicht exakt das tut, was ich als intention hatte, aber mangels wissens nicht genau so beschreiben konnte. Wer eine FAQ schreibt, setzt sich zwischen alle Stühle. Er wird von allen angegriffen und von kaum einem gelobt. Und gerade diejenigen, die am meisten von einer FAQ profitieren, sind die größten Kritiker. Nix ist recht. Nix ist brauchbar. Eine sehr gute FAQ zu schreiben, die diverse Beispiele enthält, die auch von einem Anfänger verstanden werden ist nicht nur etwas aufwendig, sondern sehr aufwendig --- schließlich sollten die Beispiele auch funktionieren, d.h. ausgetestet werden. Das wiederum bedeutet: neues Software-Release gleich überarbeiten der FAQ. Viel besser als eine einfache FAQ wäre, wenn die vorhandene "FAQ", die SuSE-Hilfe-DB nicht nur von SuSE verwaltet werden würde, sondern von vielen freiwilligen, ehrenamtlichen Helfern. Ob es dafür eine kleine Entschädigung von SuSE gibt wäre zu überlegen. Das ist aber seitens SuSE bisher nicht unterstützt. Meine Lust hier ausführliche Anleitungen für irgendetwas zu schreiben hat deswegen mit der Zeit deutlich nachgelassen. -- Thomas
participants (1)
-
Thomas Schweikle