#techdok — Public Fediverse posts

Vielleicht verschenke ich zu Weihnachen an ein paar Geschäftspartner einen aktuellen Duden. #justthinkin #techdok

Vielleicht verschenke ich zu Weihnachen an ein paar Geschäftspartner einen aktuellen Duden. #justthinkin #techdok

Klar, natürlich kann man eine Tabelle auch als Excel-Screenshot in ein Word-Dokument einfügen. Ist dann halt kacke. 🤯 #techdok

Klar, natürlich kann man eine Tabelle auch als Excel-Screenshot in ein Word-Dokument einfügen. Ist dann halt kacke. 🤯 #techdok

Wenn ihr in der Revisionshistorie in einem technischen Dokukment lapidar "Anpassung Abbildung 73" schreibt, dann macht da bitte entweder eine Referenz auf das Objekt oder schreibt auch den Titel der Abbildung mit dazu. Wenn später irgendwann mal eine Abbildung 54 eingefügt wird, wird die Abbildung 80 nämlich zur Abbildung 81. Und wenn dann jemand – aus Gründen – frühere Änderungen in dem Dokument nachvollziehen soll, wird's das schwierig bis unmöglich. #documentarian #dokumentation #techdok

Wenn ihr in der Revisionshistorie in einem technischen Dokukment lapidar "Anpassung Abbildung 73" schreibt, dann macht da bitte entweder eine Referenz auf das Objekt oder schreibt auch den Titel der Abbildung mit dazu. Wenn später irgendwann mal eine Abbildung 54 eingefügt wird, wird die Abbildung 80 nämlich zur Abbildung 81. Und wenn dann jemand – aus Gründen – frühere Änderungen in dem Dokument nachvollziehen soll, wird's das schwierig bis unmöglich. #documentarian #dokumentation #techdok

Es gibt allerlei DIN-Normen für technische Zeichnungen, insbesondere im Bereich Maschinenbau. Kennt von euch jemand irgendwelche Normen, Vorgaben, branchenweit geltende Definitionen für Zeichnungen – insbesondere Netzwerk-Pläne – im IT- und Rechenzentrumsumfeld?

Weil irgendwie macht jeder in Visio, was ihm halt gerade gefällt, oder wie er's in der Cisco-Doku gesehen hat. Aber das scheint mir bei weitem nicht der Weisheit letzter Schluss zu sein. #techdok

Es gibt allerlei DIN-Normen für technische Zeichnungen, insbesondere im Bereich Maschinenbau. Kennt von euch jemand irgendwelche Normen, Vorgaben, branchenweit geltende Definitionen für Zeichnungen – insbesondere Netzwerk-Pläne – im IT- und Rechenzentrumsumfeld?

Weil irgendwie macht jeder in Visio, was ihm halt gerade gefällt, oder wie er's in der Cisco-Doku gesehen hat. Aber das scheint mir bei weitem nicht der Weisheit letzter Schluss zu sein. #techdok

Ein Autor hat in einem 300 Seiten dicken, technischen Dokument intensiv quer und auf externe Referenzen verwiesen. Weil der Autor unwissend war, hat er das alles als Fließtext gemacht und keine "echten" Referenzen benutzt. Es haben sich Kapitel verschoben, es wurden neue Kapitel und Unterkapitel eingefügt, es wurden neue Dokumente in die Referenzliste aufgenommen. Seit anderthalb Tagen repariere ich Referenzen in dem Dokument. Einmal mit Profis … #techdok

Ein Autor hat in einem 300 Seiten dicken, technischen Dokument intensiv quer und auf externe Referenzen verwiesen. Weil der Autor unwissend war, hat er das alles als Fließtext gemacht und keine "echten" Referenzen benutzt. Es haben sich Kapitel verschoben, es wurden neue Kapitel und Unterkapitel eingefügt, es wurden neue Dokumente in die Referenzliste aufgenommen. Seit anderthalb Tagen repariere ich Referenzen in dem Dokument. Einmal mit Profis … #techdok