Hallo Carsten,
Perfektion ist kein Zustand, sondern ein Ziel, auf welches man zustreben kann
Leerzeichen ist zu viel (sagt auch mein Duden...). Das mit den Seitenumbrüchen: Grundsätzlich ja, ist allerdings recht mühsam, das in jeder Version immer wieder anzupassen...3.1.2:
Bei dasselbe ist ein Leerzeichen zuviel. Vielleicht ist hier auch ein dezenter Seitenumbruch günstig, damit das Codebeispiel ungetrennt bleibt.
Begründung? (und sag jetzt nicht, Anglizismen seien böse )Das LaTeX-File (2 mal) würde ich in LaTeX-Datei ändern, wie es ja schon in 3.1.4 richtig ist.
Ok; Und die Begründung dazu? Ich habs getrennt geschrieben (Bounding-Box Problem), da ich das Wort Bounding-Box hervorheben wollte... (das wär meine Begründung)3.1.5:
Bounding-Box-Problem ist ein Wort (Stichwort Durchkopplung)
(3.2.3) Für mich zählt das mehr als Aufzählung... Lasse mich aber mit guter Begründung gerne umstimmen.3.2.3:
Sicher! Es ist doch ein Satz... oder etwa nicht?
Finde ich nicht zwingend - schadet aber auch nichts, wenn ich den noch anfüge.3.3.4:
\includegraphics braucht noch einen Backslash (ist ja ein LaTeX-Befehl).
Gute Idee. (zum "Bindestrich" später noch mehr)3.4.1:
Den Satz würde ich nicht mit LaTeX-Code anfangen, sondern sowas wie "Die figure-Umgebung versucht, ..." schreiben.
vgl. später3.4.2:
Wieder "... figure-Umgebung ..."
Vergleiche weiter oben.3.4.2: Seitenumbruch im Codebeispiel...
Yep (bzw: Gibt es das selbe gar nicht oder hat das ne andere Bedeutung?)3.4.2: 3. Anmerkung: Schon wieder dasselbe mit dem Leerzeichen
Ersteres könnte man, das zweite auf keinen Fall (da der Paketnamen schon einen Bindestrich enthält, wäre so nicht mehr sauber sichtbar, was der Paketnamen ist und was nicht). Bei jedem anderen Fall hätte ich den "Bindestrich" auf jeden Fall gesetzt, in diesem Fall hab ichs absichtlich weggelassen, damit die Paketnamen alleine da stehen (vergleiche auch vorherige Kritikpunkte hierzu). Wenn du nicht noch ein ganz starkes Argument dafür lieferst, werd ichs getrennt lassen1. Anmerkung: caption-Paket und capt-of-Paket werden durchgekoppelt, so wie es in der 3. Anmerkung schon bei der table-Umgebung richtig ist.
Vergleiche vorhergehende Kommentare3.5.1:
Seitenumbruch im Beispiel...
multicol-Paket, captionof-Befehl durchkoppeln
3.5.2:
3 mal Durchkopplung
Ja.3.6.1:
\fbox und \fcolorbox mit Backslash
Recht hast du ja - ich finds aber schöner, wenn da der ganze Code steht. Und so viel Platz braucht der ja auch wieder nicht3.6.2:
Möglichst vollständigen Code zu haben, würde komplette Minimalbeispiele bedeuten. Da das eh nicht der Fall ist, kann man hier auch nur die eine Zeile bringen.
yep.3.6.3:
Umbruch...
Achtung: \caption und \label mit Backslash.
jep.3.6.5:
Und wieder mal ein Backslash.
jep.3.6.8:
Und wieder drei Backsläsches...
jep.3.6.9:
siehe 3.6.8...
Notwendig: Ja (bzw. muss ich mir nochmals überlegen). Aber ich kanns ja nochmals verkleinern - dann kann man zwar gar nix mehr lesen, aber ist ja ne Vektorschrift5:
Ist die Geschichte des Dokuments in dieser Ausführlichkeit notwendig? Wenn ja, dann tut es vielleicht auch eine kleinere Schriftgröße, wie bei 4.?
Kurz: Ja. Aber die Übersichtlichkeit sollte nicht leiden (sonst könnte ich das ganze File ja auch zippen )Generell finde ich, solltest du die Codebeispiele nochmal konsequent auf Leerzeilen und "..." überprüfen, ob da vielleicht doch noch was gespart werden kann. Denk an den ersten Satz des zweiten Punktes im Vorwort.
Generell hätte ich auch von anderen Leuten noch gerne Bemerkungen zu:
1) Müssen Kommandos, die mitten im Text sind, wirklich Backslashes haben?
2) Soll ich besser: capt-of-Paket oder capt-of Paket schreiben
3) Wie viel fest stören die Seitenumbrüche in den Quellcode-Beispielen? Bzw. was sollte die Grenze sein, um noch einen manuellen Umbruch reinzuhauen?
4) History zu lang? Verkleinern (Umfang und oder Textgrösse)
Merci für die Rückmeldungen,
mfG Bischi
Lesezeichen