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

Am 07.02.2013 um 10:52 schrieb Bjoern Meier <bjoern.meier@gmail.com>:

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 gesagt, bisher habe ich das in einem nicht öffentlichen Wiki geschrieben. Warum sowas nicht ein wenig für andere öffnen. Ich bin mir sicher WPKG wurde noch nicht x-Mal in dieser Weise beschrieben. Mailserver sicherlich.

An anderer Leute Doku (mit) zu schreiben ist halt nochmal was anderes. Ich habe Spezialfälle und kenne auch nur diese. Das spiegelt sich natürlich im Blog. Eine echte Doku muss da etwas tiefer gehen.

- 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

Zielgruppe? Ich denke jeder der die beschriebenen Sachen brauchen kann kennt LVM oder weiß wie er es schnell rausfinden und bewerten kann.

ersten Satz, von WPKG erwähnst du den ersten Artikel. Um dorthin zu gelangen muss ich aber erst ganz nach unten scrollen.

Ich benutze das Wiki nur intern. Das Blog ist Wordpress.

- 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.

Jepp. Deswegen will ich ja, bevor ich wieder gedrängt werde ein Buch zu schreiben, das Blog ein wenig laufen lassen. Auch um die Zielgruppe etwas besser einschätzen zu können.

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

Die Kapitel aus dem Wiki werden leider nicht übernommen. Mal sehen was mir da noch einfällt.

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

Kann ich ja mal einbauen, danke für den Hinweis. Aber ja, ich mag kein Papier.

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.

Gut, ich wollte jetzt nicht mit der Marketingabteilung von Microsoft konkurrieren. ;) Aber ja, das ist gut gemacht.

Danke.