not quite minimalistic enough  

Kraut und Rüben

Das Handbuch für die aktuelle Firmwareversion 2.4 von Ciscos SG550X-Switches ist ein völliges Chaos. Ich empfehle, es einfach mal daumenkinomäßig schnell durchzublättern und dabei aus dem Augenwinkel auf die Kapitelnummern zu schauen.

Wem das noch nicht reicht, der sollte sich auch noch daran versuchen, anhand des Inhaltsverzeichnisses eine bestimmte Stelle zu finden. Als nächstes empfiehlt es sich dann, sich mal die Seitenzahlen an Kapitelgrenzen anzusehen.

Auf der Titelseite des Buches ist eine etwas unmotiviert erscheinende »Version 0.4« angegeben; es mag sein, daß auch Cisco das Buch noch nicht für fertig hält. Brauchbar ist es jedenfalls ohne größere Aufräumarbeiten nicht.

Ich war gezwungen, einige spannende Stunden mit Acrobat zu verbringen (der dabei nur einmal abgestürzt ist und dabei nur etwa fünf Minuten Arbeit mitgerissen hat!). Jetzt habe ich eine Fassung, die zwar etwas unschön ist, weil die Kapitel teilweise auf geraden (also linken) Seiten anfangen, dafür hat es jetzt aber:

Jetzt muß bloß noch der Inhalt halbwegs tauglich sein.

Wie kommt eine solche Situation eigentlich zustande? Ich kenne FrameMaker nicht aus eigener Anschauung, aber es ist doch damit bestimmt einfacher, es richtig zu machen, als so, oder?

(Die Fassung des Buches für die vorherige Firmwareversion 2.3 ist übrigens auf den ersten und zweiten Blick fehlerfrei.)

Written on August 16, 2018