dokumentation

Schrei­ben ist tot

OK. Das ist jetzt Click-bait. Bes­ser wäre es zu sagen: Schrei­ben als Grund­la­ge der Infor­ma­ti­ons­ver­mitt­lung in der tech­ni­schen Doku­men­ta­ti­on ist ver­al­tet....
dokumentation

Zitat der Woche

Für einen Tech­ni­schen Redak­teur ist es nicht ganz ein­fach, Zita­te zu fin­den, die auf den Zusam­men­hang zwi­schen Gesell­schaft und Doku­men­ta­ti­on hin­wei­sen, aber hier ist ein sehr schö­nes und auch tref­fen­des Zitat: Peop­le...
dokumentation online publishing redaktion technische dokumentation

Wahl der Waf­fen, Teil III: Wiki oder Online­hil­fe?

(Bild­quel­le sie­he unten) Alle wol­len weg vom Papier. Auch in der Tech­ni­schen Doku­men­ta­ti­on ste­hen Doku­men­ta­ti­ons­ver­ant­wort­li­che und Redak­teu­re oft vor der Ent­schei­dung: soll ich einer ver­meint­li­chen Geset­zes­la­ge fol­gen und für den Anwalt doku­men­tie­ren oder...
dokumentation

Her­mann Zapf †

(Bild­quel­le: http://www.p‑stadtkultur.de/die-meisterhafte-typographie-des-hermann-zapf/) Her­mann Zapf, einer der ganz gro­ßen Typo­gra­phen, des­sen Schrif­ten fast jeder schon gese­hen hat, ist am 4. Juni im Alter von 96 Jah­ren gestor­ben. Sei­ne Schrif­ten haben ver­mut­lich mehr zur...
dokumentation

Redak­ti­ons­sys­te­me: Es ist auf­ge­tra­gen!

Leh­nen wir uns ein­mal kurz zurück und betrach­ten den bis­he­ri­gen Stand: Wir haben alle Daten in das Sys­tem migriert, haben die Red­un­danz weit­ge­hend besei­tigt, indem die Infor­ma­ti­ons­häpp­chen so ange­legt sind, dass sie...
dokumentation

Topics: Infor­ma­ti­ons­häpp­chen hirn­ge­recht ser­vie­ren

Vor allem im Bereich der Soft­ware-Doku­men­ta­ti­on ist es oft über­ra­schend, wie viel wir von der Mate­rie zu ver­ste­hen glau­ben und wie wenig wir davon tat­säch­lich anwen­den kön­nen. Das liegt aber nicht an der...
dokumentation

Redak­ti­ons­sys­te­me, Epi­log: Anpa­cken – aber wo?

Eigent­lich hat­te ich schon beschlos­sen, es mit dem doch recht lan­gen Trak­tat zu Redak­ti­ons­sys­te­men in der Tech­ni­schen Doku­men­ta­ti­on bewen­den zu las­sen. Immer­hin ist der Text sehr theo­rie­las­tig, da es sich ja in...
dokumentation

Sche­ma­ti­sche Dar­stel­lung: Die Prin­zi­pi­en sehen

Wie auch an der Web­site unschwer erkenn­bar ist: Ich schrei­be gern. Es berei­tet mir kei­ne grö­ße­re Mühe, ein paar flot­te Sät­ze aufs Papier bzw. den Bild­schirm zu wer­fen, zu über­ar­bei­ten und dann...
dokumentation

Redak­ti­ons­sys­te­me: Lei­dens­druck oder Knopf­druck?

Dem Mit­tel­stand in Deutsch­land haf­tet der Geruch an, bie­der und klein­bür­ger­lich zu sein. Das gilt auch für den bei Bedarf immer ger­ne gelob­ten Maschi­nen­bau. Dort wer­den auf der grü­nen Wie­se aus –...
dokumentation

Auf­merk­sam­keits-Steue­rung in der Tech­ni­schen Doku­men­ta­ti­on: Hin­gu­cken las­sen

Dass sowie­so kei­ner die Doku­men­ta­ti­on liest, damit haben sich die meis­ten Redak­teu­re abge­fun­den. Es stimmt aber nicht. Eine Doku­men­ta­ti­on besteht aus zwei Tei­len (das wird in einer so gen­an­ten DITA auch kor­rekt...
dokumentation

Kon­zep­tio­nel­les Arbei­ten in der Tech­ni­schen Doku­men­ta­ti­on: Wider die Linea­ri­tät

Die Tech­ni­sche Doku­men­ta­ti­on ver­langt Papier. Sie schreit nach Papier, wenn es um die „Unter­la­gen“ geht, sie spuckt Papier aus, wenn es um die Aus­ga­be geht. Wir Tech­ni­schen Redak­teu­re begin­nen eine Tech­ni­sche Doku­men­ta­ti­on...
black and red typewriter on white table
dokumentation

Die rich­ti­ge Schrift für die tech­ni­sche Doku­men­ta­ti­on

Ein The­ma, dass gern in der tech­ni­schen Doku­men­ta­ti­on ent­we­der stief­müt­ter­lich behan­delt oder als läs­tig schnell abge­hakt wird, ist die Wahl der rich­ti­gen Schrift. Das mag dar­an lie­gen, dass Schrift im All­ge­mei­nen als...