Re: Privates Dokuprojekt (Blog) / Feedback erwünscht

Hi,

Am 7. Februar 2013 09:44 schrieb Denis Witt <denis.witt@concepts-and-training.de>:

Hallo Liste,

ich pflege für meine Systeme schon seit längerer Zeit eine Systemdokumentation in einem Wiki. Einige Freunde drängen mich schon länger daraus mal ein eBook zu machen. Ein paar Wikiseiten sind natürlich noch lange kein Buch, und daher sind alle Versuche in dieser Richtung bisher gescheitert.

Aber ich habe jetzt einmal angefangen ein Blog zu schreiben und würde mich über Feedback freuen.

Die bisherigen "Highlights" sind:

Xen 4.1 und LVM:

* https://www.21x9.org/xen-4-1-installation-und-konfiguration-debian-wheezy/

Mailserver: LDAP, Dovecot, Postfix und Filter:

* https://www.21x9.org/e-mail-server-1-ldap-debian-wheezy/

* https://www.21x9.org/e-mail-server-2-dovecot-debian-wheezy/
* https://www.21x9.org/e-mail-server-3-postfix-debian-wheezy/

* https://www.21x9.org/e-mail-server-4-postgrey-spamassassin-clamav-postfix-filter/

Softwareverteilung mit WPKG und AutoIT:

* https://www.21x9.org/wpkg-windows-softwareverteilung-mit-linuxmitteln/

* https://www.21x9.org/wpkg-2-windows-softwareverteilung-einrichten/
* https://www.21x9.org/wpkg-3-wpkgexpress/

* https://www.21x9.org/wpkg-4-autoit/

Was gefällt euch besser? Ein langer Artikel wie bei Xen, oder mehrere kleinere wie beim Mailserver? Ist das alles verständlich geschrieben?

Wie gesagt, über Feedback würde ich mich freuen.

Vielen Dank und beste Grüße
Denis Witt

Ah, ein weiteres Dokumentationsprojekt und ein weiteres Beispiel für die Redundanz des Internets. Ich persönlich halte nichts davon, dass jeder zu einem Thema schreiben muss, dass schon X-Mal dokumentiert wurde. Ich frage mich dann:"Warum wird dann das Debian Anwenderbuch nicht aktualisiert? An der Schreibfaulheit scheint es zumindest nicht zu liegen.". Gut, das ist eine persönliche Ansicht.

Wie dem auch sei, ein paar Sachen fallen auf:

- Du benimmst ein Wiki, scheinst aber Querreferenzen nicht zu mögen. Beispiele: Ein Artikel zu Xen, ok, was zum Geier ist dann LVM? Wird nicht erklärt. Im ersten Satz, von WPKG erwähnst du den ersten Artikel. Um dorthin zu gelangen muss ich aber erst ganz nach unten scrollen.

- Wie bei den meisten privaten Wikis existiert kein roter Faden. Das ist - für mich - der Unterschied zu einem eBook. Es gibt einen guten linearen Aufbau, nicht vereinzelte Spezialthemen.

- Mach die Artikel kleiner und ordne diese besser. Ich finde deine fehlende Struktur anstrengend. Es gibt zwar Absätze aber keine Unterkapitel.

- Hast du was gegen Papier oder ist es ein Versehen, dass es keine Druckansicht gibt?

Persönliche Meinung: Nett gemeint und für diese Spezialthemen mal brauchbar. Nur ist es weder Massen tauglich oder als Referenz geeignet.

Ich oute mich mal. Ein gutes Beispiel wie man es macht, ist für mich die MSDN. Diese ist sowohl als Referenz und als Lernmaterial verwendbar. Sie hat gleichbleibende Beispiele (contoso.com), erklärt technische Hintergründe und ist - zumindest für mich - sehr klar und deutlich strukturiert. Man kann sogar über Versionen hinweg sehen, wie ein Befehl sich veränderte.

Gruß

Björn