Generated by All in One SEO v4.9.2, this is an llms.txt file, used by LLMs to index the site. # Die Redakteuse Über den Tellerrand der Technischen Redaktion ## Sitemaps - [XML Sitemap](https://www.redakteuse.de/sitemap.xml): Contains all public & indexable URLs for this website. ## Beiträge - [Mit DITA um die Welt - tekom-Jahrestagung 2012](https://www.redakteuse.de/2012/10/26/mit-dita-um-die-welt-tekom-jahrestagung-2012/) - Die tekom-Jahrestagung 2012 ist überstanden und es war mal wieder sehr interessant und schön dabei zu sein. Vorab gibt es hier erst einmal die Folien zu meinem Vortrag "Mit DITA um die Welt". Der Rückblick folgt in den nächsten Tagen. Ich gehöre nicht zu den Schnell-Bloggern wie Kai oder Sarah, die ihre Eindrücke wirklich rasend - [Lokalisierung für Anfänger](https://www.redakteuse.de/2009/06/02/lokalisierung-fur-anfanger/) - Hach, auch ein Global Player wie Hasi und Mausi kann ins Fettnäpfchen treten. Da widme ich mich über die Feiertage dem angenehmen Online-Shopping, als mir die neue Kampagne ins Auge springt. Allerdings weniger wegen der Shirts: Eingabe? Wieso Eingabe? Was soll ich denn da eingeben? Moment, dem erfahrenen Software-Dokumentar fällt sofort die Eingabe-Taste ein. Und - [tekom Jahrestagung 2010 - Rückblick](https://www.redakteuse.de/2010/11/08/tekom-jahrestagung-2010-rucklick/) - So, es ist geschafft :) Ich habe den Beinahe-Laptopausfall und die Vor-Vortrags-Nervosität halbwegs überstanden und ich denke, mein Vortrag ist ganz gut angekommen. Aber Genaueres weiß ich erst, wenn die Feedback-Bögen eintreffen. Und da bin ich äußerst gespannt! Meine Folien werde ich demnächst hier veröffentlichen sind nun unter Downloads erhältlich. Nun, wie sah es mit - [tekom15: Faster than agile](https://www.redakteuse.de/2015/11/25/tekom15-faster-than-agile/) - So, nach der ganzen DITA-Aufregung kommen wir nun zu etwas völlig anderem. Naja, ein bisschen DITA ist auch dabei, aber hey, ihr wisst, wo ihr hier lest ;-) Ich habe mir Jang Graats Vortrag "Faster than agile" angeschaut. Gerade bin ich wieder mittendrin in einem agilen Projekt und da klang das doch vielversprechend. Vorab muss ich - [DITA & Deutschland](https://www.redakteuse.de/2015/11/13/dita-deutschland/) - Leider war ich in diesem Jahr nur am 2. Tag auf der tekom-Tagung und habe so die beiden Sessions verpasst, die sich eher kritisch mit DITA auseinander setzten oder wie Sarah O'Keefe sie zusammenfasste: DITA is bad. Die Tweets dazu waren sehr unterhaltsam und ich hätte die Diskussionen gerne live erlebt. Heads of members of the - [Und jetzt?](https://www.redakteuse.de/2015/04/08/und-jetzt/) - So, es sind also nur locker-flockige 2,5 Jahre seit dem letzten Blogpost vergangen. Ich schiebe das Blog-Thema ja schon so eine Weile vor mir her. Soll ich es archivieren? Wie fange ich wieder an? Über was blogge ich? Nach 1 Jahr Elternzeit müssen sich die Synapsen ja auch erst einmal wieder auf das Thema Redaktion - [Redakteuse live – tekom Jahrestagung 2012](https://www.redakteuse.de/2012/09/25/redakteuse-live-tekom-jahrestagung-2012/) - Die tekom-Jahrestagung in Wiesbaden rückt näher und selbstverständlich bin ich wieder dabei. Auch in diesem Jahr gibt es einen großen Track zum Thema "Content Strategy", der wieder mit einer Vielzahl an interessanten Vorträgen lockt. Aber auch ansonsten klingt das Programm sehr vielversprechend und daher wird es wieder wie immer schwer sich zu entscheiden, in welchen - [Eine Unkonferenz - Barcamp Karlsruhe 2012](https://www.redakteuse.de/2012/07/17/eine-unkonferenz-barcamp-karlsruhe-2012/) - Den Begriff "Barcamp" hatte ich schon öfter mal gehört, aber so richtig bewusst habe ich mich damit nicht beschäftigt. Bis ich dieses Jahr mitbekommen habe, dass es ein Barcamp in Karlsruhe gibt. Ein Barcamp ist eine Unkonferenz und zwar in dem Sinne, dass es im Vorfeld zwar ein Thema (hier war es allgemein "Netzkultur"), aber - [Wie weit sollte CMS-Abhängigkeit gehen?](https://www.redakteuse.de/2012/05/18/wie-weit-sollte-cms-abhangigkeit-gehen/) - Diese Frage stelle ich mir, seit ich auf der tekom-Frühjahrstagung im Vortrag "Content-Management powered by PI-Mod" von Stephan Steurer mit Special Guest Prof. Ziegler saß. PI-Mod ist ein XML-Standard für Dokumentation, der vor ca. 4 Jahren unter Federführung von Prof. Wolfgang Ziegler entstand und in den die Anforderungen aus vielen Kundenprojekten aus dem Maschinen- und - [Konferenz für Informationsarchitektur 2012 - Rückblick](https://www.redakteuse.de/2012/05/15/konferenz-fur-informationsarchitektur-2012-ruckblick/) - Ich interessiere mich schon lange für Informationsarchitektur - wie baut man Informationen so auf, wie stellt man sie so dar, dass sie möglichst einfach gefunden werden? Das klingt auch erst einmal einfach nach der Beschreibung eines technischen Redakteurs ;) Eine gute Beschreibung einer Konzepter/Informationsarchitekten-Stelle gibt es bei designerdock. Mir wurde die Konferenz für Informationsarchitektur schon - [Nachtigall, ick hör dir twittern!](https://www.redakteuse.de/2012/05/07/nachtigall-ick-hor-dir-twittern/) - "Twitter? Darüber kann man Leute kennen lernen?" Das war die Reaktion eines mir nahestehenden Nicht-Twitterers als ich ihm erzählte, dass ich die eben zufällig getroffene Dame über Twitter kennen gelernt hatte. Tja, und wie ich dann so erzählte, wie toll das mit dem Twittern sein kann, ja, da dachte ich mir, dass könnte ich euch - [tekom Frühjahrstagung 2012 - Dies und das](https://www.redakteuse.de/2012/04/30/tekom-fruhjahrstagung-2012-dies-und-das/) - CMS-Coaching von Nebil Messaoudi Nebil teilte in diesem Kurztutorial seine bisherigen Erfahrungen mit CMS-Einführungen mit uns. Wenn man selbst schon einmal ein CMS eingeführt hat, kommt einem einiges bekannt -nur zu bekannt- vor. Manch einer konnte sich auf die Schulter klopfen und sagen: "Ja, das haben wir zum Glück von Anfang an beachtet", aber so - [tekom Frühjahrstagung 2012 - Experience Design](https://www.redakteuse.de/2012/04/27/tekom-fruhjahrstagung-2012-experience-design/) - So, bevor ich in mein wohlverdientes Wochenende bei 26°C entschwinde, hier noch schnell die ersten Eindrücke, so lange sie noch frisch sind ;-) Ich war bisher noch auf keiner Frühjahrstagung, aber da sie diesmal in meiner schönen Heimatstadt Karlsruhe stattfand, gab es keine Ausrede. Erster Eindruck: sehr familiär im Vergleich zur riesigen Jahrestagung. Die Frühjahrstagung - [Communities für alle!](https://www.redakteuse.de/2012/03/29/communities-fur-alle/) - In meinem letzten Post habe ich es schon angeschnitten: das Thema "Lokalisierung von Communities". (Ich konzentriere mich hierbei weiterhin vor allem auf Hilfe-Communities, d.h. Plattformen, die Hilfetext enthalten, die auch durch die User bearbeitet werden können.( Es ist ein ziemlich ungeliebtes Thema, fürchte ich. Ich kann mich noch daran erinnern, wie beim Content-Strategy-Tag der tekom-Tagung 2011 - [Community Management und technische Kommunikation](https://www.redakteuse.de/2012/03/14/community-management-und-technische-kommunikation/) - In den letzten Monaten ist das Thema "Die Zukunft des Technischen Redakteurs" ziemlich präsent gewesen. Mit den trendigen Themen Crowdsourcing und Community stellt man sich als technischer Redakteur so langsam die Frage: "Verlier ich meinen Job an die Crowd in der Cloud?". Ein mögliches Betätigungsfeld, oder besser gesagt: ein Feld bei dem wir Redakteure uns - [Gelesen: DITA Best Practices](https://www.redakteuse.de/2011/11/22/gelesen-dita-best-practices/) - Vor kurzem ist das Buch DITA Best Practices: A Roadmap for Writing, Editing, and Architecting in DITA von Laura Bellamy, Michelle Carey und Jenifer Schlotfeldt erschienen. Bei dem Wort "Architecting" im Untertitel bin ich hellhörig geworden, denn die meisten Bücher, die derzeit auf dem Markt sind beschäftigen sich entweder stark mit den Basics (Warum soll - [Wiederverwendbarkeit um jeden Preis?](https://www.redakteuse.de/2011/10/31/wiederverwendbarkeit-um-jeden-preis/) - Das Prinzip der Wiederverwendbarkeit ist etwas, das die Software-Entwicklung und die technische Redaktion gemein haben: Redundanz ist böse ;-) Deswegen macht es mir auch eher Spaß Entwicklern zu erklären, worum es bei meiner Arbeit vor allem geht: sie verstehen nämlich (meistens) ziemlich schnell, welche Probleme wir als Redakteure haben (und warum es Probleme sind!) und - [tekom 2011 - Content Strategy](https://www.redakteuse.de/2011/10/29/tekom-2011-content-strategy/) - Auf der Jahrestagung 2011 gab es die so genannten Trendthemen, welchen dann jeweils ein gesamter Vortragsstrang an einem Tag gewidmet wurde: "Mobile Dokumentation" und "Content Strategy". Von ersterem Thema habe ich leider gar nichts mitbekommen, weil ich zum Einen auf einem 1,5stündigen Workshop war und zum Anderen dann parallel stattfindende Vorträge vom Thema her bevorzugen - [Die Redakteuse schreibt auch für dich!](https://www.redakteuse.de/2011/10/17/die-redakteuse-schreibt-auch-fur-dich/) - Hier und da konnte man es schon von Twitter ahnen und der eine oder andere wusste es: ich arbeite ab sofort freiberuflich als Technische Redakteurin. Ich werde weiterhin hier als Redakteuse schreiben, aber wer nun auch mit mir zusammenarbeiten will, darf gerne zu mp dokumentation rübergehen. Heute mache ich mich auch auf den Weg zur - [Umfrage: Wer nutzt eigentlich DITA?](https://www.redakteuse.de/2011/07/04/umfrage-wer-nutzt-eigentlich-dita/) - Ich melde mich aus dem Blog-Nirwana und will zu allem Überfluss, dass meine Leser mal ganz kurz aktiv werden. Ganz schön frech ;) Ich habe auf diversen Konferenzen schon mal hier und da nachgehakt, wer in Deutschland denn eigentlich mit DITA arbeitet. Es gibt immer zahlreiche Vorträge, die auch gut besucht sind, aber wer arbeitet - [Jeder kann schreiben](https://www.redakteuse.de/2011/03/09/jeder-kann-schreiben/) - In diesem Beitrag zum Beruf des technischen Redakteurs habe ich bereits den Punkt "Undankbarkeit" erwähnt. Wann immer es um Text (und auch um Grafik, wie ich von befreundeten Grafik-Designern weiß) geht, hat die Allgemeinheit die Vorstellung: "Ja, das schreib ich schnell selber zusammen." Oft kommen dabei Texte raus, die einem textliebenden Menschen den Magen umdrehen - [Redakteuse live "DITA - Grundlagen und Tipps für Einsteiger"](https://www.redakteuse.de/2011/02/18/redakteuse-live-dita-grundlagen-und-tipps-fur-einsteiger/) - Im Rahmen der Abendveranstaltungen der tekom-Regionalgruppe Baden halte ich am 23.02. in Karlsruhe einen kleinen Vortrag zu meinem Lieblingsthema :-) Für alle DITA-Interessierten mit Grundkenntnissen in XML und Standardisierung gibt es einen kleinen Rundblick mit folgenden Punkten: * Was ist DITA? * Für welche Einsatzzwecke ist DITA geeignet? * Was sind die Vor- und Nachteile? - [Linkklassen und Usability](https://www.redakteuse.de/2010/12/07/linkklassen-und-usability/) - Das DITA-Open Toolkit unterscheidet im XHTML-Output zwischen Links auf Concepts, References und Tasks. Konkret werden die Links wie hier angezeigt: Mal abgesehen davon, dass die vom Open Toolkit mitgelieferten deutschen Standard-Überschriften "Zugehörige Konzepte/Tasks" etwas wunderlich klingen, bin ich persönlich kein Freund dieser Aufteilung der Links. Ich habe z.B. an der Hochschule gelernt, dass solche Topic-Beziehungen - [tekom 2010: Documentation for Software Engineers](https://www.redakteuse.de/2010/11/19/tekom-2010-documentation-for-software-engineers/) - In meinem ersten Job wurde ich zur Betreuung der internen Dokumentation und des Firmen-Wikis eingestellt. Die Vision damals war, dass ich mal tüchtig aufräume und danach alle Abteilungen in der Firma tolle Dokumentation haben. Nun, das wäre super gewesen :) Aber ich musste feststellen, dass das so einfach nicht ist. Es kommt zum einen darauf - [Terminologie: DITA und DITA Open Toolkit](https://www.redakteuse.de/2010/11/18/terminologie-dita-und-dita-open-toolkit/) - Desöfteren ist mir aufgefallen, dass hier und da die Terme "DITA" und "DITA Open Toolkit" miteinander vermischt werden - das mag ich als strenge Redakteuse nicht leiden. Beispiel: "DITA generiert das so und so." Jetzt muss ich einfach mal damit aufräumen und sagen: DITA Hier handelt es sich um die Darwin Information Typing Architecture. Das - [Redakteuse live - tekom Jahrestagung 2010](https://www.redakteuse.de/2010/11/01/redakteuse-live-tekom-jahrestagung-2010/) - Die alljährliche tekom-Jahrestagung rückt näher und ich freu mich schon riesig. Noch mehr freue ich mich, wenn ich den einen oder anderen Leser für meinen Vortrag "User assistance mit DITA" gewinnen kann - gerne auch die Kollegen mitbringen ;) Hier nochmal als Erinnerung, wann und wo ihr mich dort finden könnt: User assistance mit DITA - [Muttersprachen-Prinzip](https://www.redakteuse.de/2010/10/29/muttersprachen-prinzip/) - Mein letzter Blogpost wurde netterweise von Sarah O'Keefe übersetzt und im Scriptorium-Blog "wiederverwendet". In Anbetracht der durchaus großen englischsprachigen Blog-Szene im Bereich Technische Redaktion habe ich mir schon oft überlegt auf Englisch zu schreiben, weil ich damit vermutlich ein größeres Publikum erreichen würde. Und Sarah hätte hier einfach nur verlinken können ;) Warum ich es - [DITA-OT um Sprachen erweitern](https://www.redakteuse.de/2010/10/19/dita-ot-um-sprachen-erweitern/) - Das DITA-Open-Toolkit bringt schon ziemlich viele Sprachen mit sich, aber irgendwo findet sich doch immer eine, die doch noch nicht abgedeckt ist. Das Hinzufügen neuer Sprachen ist glücklicherweise kein Hexenwerk. Allerdings gilt letztere Aussage nur für Sprachen mit der Schreibrichtung "links nach rechts" - die andere Richtung hab ich noch nie getestet und weiß nicht, - [Content-Management über Ordner und SubVersion](https://www.redakteuse.de/2010/09/29/content-management-uber-ordner-und-subversion/) - Wie man meinem Blog entnehmen kann, beschäftige ich mich seit ca. 2 Jahren mit DITA. Anfangs haben wir unsere Daten über Ordner und SVN verwaltet. Inzwischen haben wir schon fast alles im Redaktionssystem drin - das SVN ist bald Geschichte. Da ich aber weiß, dass ein Redaktionssystem häufig zu den unerfüllten Träumen von technischen Redakteuren - [Softwarelokalisierung und Kontext](https://www.redakteuse.de/2010/09/25/softwarelokalisierung-und-kontext/) - Ich habe bereits erwähnt, dass ein GUI-Texter/Übersetzer einfach nur eine Datei mit Text bekommt, im schlimmsten Fall eine ellenlange Datei mit Tausenden von Einträgen. Die Schwierigkeit hierbei ist nun, dass man gar nicht weiß wo der Text genau erscheint, in welchem Kontext er sich befindet, wenn man einfach nur die Datei vor sich hat. In - [Softwarelokalisierung: Formate und Arbeitsablauf](https://www.redakteuse.de/2010/09/24/softwarelokalisierung-formate-und-arbeitsablauf/) - Weiter geht es mit meiner angefangenen Serie zur Software-Lokalisierung für Technische Redakteure Formate und Tools Die Formate mit denen man sich auseinandersetzen muss, sind vielfältig. Es hängt von der eingesetzten Technologie ab und vielleicht auch von den Präferenzen der jeweiligen Entwicker. Mit diesen Formaten habe ich im Bereich von Webapplikationen am häufigsten zu tun: PO-Dateien, - [Arbeite mit DITA und sprich darüber?](https://www.redakteuse.de/2010/08/26/arbeite-mit-dita-und-sprich-daruber/) - Ich war in den letzten Monaten häufiger in der Situation, das ich Kollegen aus anderen nicht-TR-Abteilungen erklären musste, wie wir in unserem Team eigentlich inzwischen Hilfe schreiben und warum manches nicht mehr so läuft wie früher. Das Wort DITA nehme ich dabei übrigens eigentlich nur ganz nebenbei in den Mund. Warum? Weil es den Damen - [Technische Redaktion - eine gute Wahl?](https://www.redakteuse.de/2010/08/16/technische-redaktion-eine-gute-wahl/) - Diese Woche bekam ich eine Anfrage einer zukünftigen TR-Studentin, die gerade etwas verunsichert ist: Seit ich die Zusage habe stolpere ich aber eigtl. nur noch über Berichte, wie langweilig und undankbar der Job als Technische Redakteurin sei und dass sowieso die meisten nicht lange in diesem Job durchhalten. Langweilig deswegen, weil es oft nur noch - [Technische Redaktion - More than words](https://www.redakteuse.de/2010/06/04/technische-redaktion-more-than-words/) - Vor kurzem gab es ein Ehemaligentreffen an der HS Karlsruhe an der ich meinen Master in Technischer Redaktion gemacht habe und bei dem auch Noch-Studenten dabei waren. Bei dieser Gelegenheit sollten Ehemalige Vorträge über ihre bisherigen Berufserfahrungen halten und da musste ich einfach darüber referieren, wie ich die Technische Redaktion inzwischen sehe :) Bei der - [Software-Lokalisierung für Technische Redakteure](https://www.redakteuse.de/2010/05/26/software-lokalisierung-fur-technische-redakteure/) - In der Softwarebranche kommen technische Redakteure früher oder später mit dem Thema "Oberflächentexte" in Berührung. Ob sie sie schreiben oder nur verwalten dürfen, variiert von Firma zu Firma. Bei mir gehört das Betexten der Oberflächen zum Arbeitsalltag und hier möchte ich gerne mal berichten, wie sich das gestalten kann. Terminologiekontrolle, Hilfe und Beta-Test Ich sehe - [User assistance mit DITA - Redakteuse live](https://www.redakteuse.de/2010/05/13/user-assistance-mit-dita-redakteuse-live/) - Es war etwas ruhig in den letzten Monaten. Das lag nicht zuletzt an einem äußerst spannenden Projekt mit DITA, das zwar genug Bloggenswertes ergab, aber auch dafür sorgte, dass ich gar nicht dazu kam zu bloggen bzw. auch mal nicht über DITA nachdenken wollte :) Nichtsdestotrotz will ich meine Erfahrungen zum Thema "User assistance mit - [Metadaten-Chaos: Komplette Topics filtern](https://www.redakteuse.de/2009/12/04/metadaten-chaos-komplette-topics-filtern/) - Der Dating DITA-Vortrag kommt mir gerade wieder in den Sinn, wo ich mich Metadaten beschäftige. Und da stehen mir wirklich die Haare zu Berge - das ist das erste Mal, dass ich DITA wirklich, wirklich unpraktisch finde und noch keine gute Lösung habe, wie ich da in Zukunft verfahren soll. Wie man komplette Topics nicht - [Dateiendungen in DITA - kleines Problem](https://www.redakteuse.de/2009/11/20/dateiendungen-in-dita-kleines-problem/) - Heute ein kleiner Wissensschnipsel zu Dateiendungen in DITA. Prinzipiell ist es inzwischen erlaubt, sowohl Dateien mit XML-Endung als auch welche mit DITA-Endung in eine Map zu integrieren. Ich persönlich finde ja so einen Misch-masch nicht gut, und als ich es mal getestet habe, hat es auch nicht gut funktioniert. Kommen wir aber zu einem Problem, - [Breadcrumbs in DITA-XHTML - Update](https://www.redakteuse.de/2009/11/19/breadcrumbs-in-dita-xhtml-update/) - Ich habe das Breadcrumbs-Plugin ja bereits vorgestellt. Der damalige Bug bei der Verwendung von Reltables war sehr schnell behoben - superklasse! Aber schon damals ist mir eine unschöne Sache aufgefallen: der Text für das Wurzelelement in der Breadcrumb ist hart kodiert. Das ist natürlich gerade bei der Internationalisierung der Hilfe eher so ein bisschen doof. - [tekom-Jahrestagung 2009 #2 - Dating DITA](https://www.redakteuse.de/2009/11/18/tekom-jahrestagung-2009-2-dating-dita/) - Ich war in sage und schreiben einem DITA-Vortrag. Erstens gab es davon gar nicht so viele ("Der Hype flaut ab", wie ein CMS-Hersteller mir bestätigte), zweitens waren die meisten davon eher auf einem Anfängerlevel. Bei diesem Vortrag war ich fast geneigt nicht hinzugehen, da mir der Titel zuerst zu gewollt witzig vorkam. Ein Blick in - [tekom-Jahrestagung 2009 #2 - Embedded help](https://www.redakteuse.de/2009/11/17/tekom-jahrestagung-2009-2-embedded-help/) - So, ich versuche mal einige Vorträge derselben Themengebiete zusammenzufassen: Nicoletta Bleiel, ComponentOne - Improving Software Usability with Embedded User Assistance Ich hatte Nickys Vortrag aus dem letzten Jahr noch gut im Gedächtnis und da auch das Thema passte, bin ich also nichts wie hin. Hauptthema war Hilfe, die in die Software eingebettet ist und sich - [tekom-Dokupreis 2009 im Visier](https://www.redakteuse.de/2009/11/09/tekom-dokupreis-2009-im-visier/) - Der diesjährige Dokupreis ging an einen Waffenhersteller. Das ganze hat ein wenig Wirbel ausgelöst - einerseits bei Friedensaktivisten, andererseits wurde die Frage aufgeworfen, ob hier alles korrekt abgelaufen ist. Zu letzterem: ich kann es mir nicht wirklich vorstellen, dass hier quasi Bestechung stattgefunden haben soll, aber das ist auch schon alles, was ich dazu sagen - [tekom 2009 #1 - Erste Eindrücke](https://www.redakteuse.de/2009/11/04/tekom-2009-1-erste-eindrucke/) - So, nach einem Tag voller Eindrücke schaffe ich es sogar noch schnell einige davon zu bloggen :) Alles neu angeordnet. Die Messe ist plötzlich unten, der Kaffeestand versteckt in der Messe statt in der Nähe der Vortragsräume (was ich sehr doof finde, denn das war der perfekte Ort zum Socializing nach den Vorträgen). Der Mensch - [Community-Übersetzungen mit Google Translate](https://www.redakteuse.de/2009/11/02/community-ubersetzungen-mit-google-translate/) - Es ist der Traum eines jeden Budgetverantwortlichen: "Wir stellen den zu übersetzenden Text ins Internet und die Community macht den Rest. Bei Wikipedia klappt das doch auch und bei dem ganzen Open-Source-Kram. Die Leute machen das umsonst." Facebook setzt schon voll auf die Community bei diesen Dingen. Google Translate Bevor ich weiter in die "Ja, - [tekom-Tagung 2009 - Countdown](https://www.redakteuse.de/2009/11/02/tekom-tagung-countdown/) - Pünktlich zum Highlight des TR-Jahres erwache ich wieder aus dem Blog-Koma :) Eiiigentlich gäbe es zur Zeit viel zu bloggen, doch ist es mir in den letzten Wochen schwer gefallen auch wirklich etwas zu schreiben. Manchmal muss man abends auch ein bisschen Abstand zum Beruf gewinnen - man nennt es auch Freizeit ;) In Anbetracht - [Task-Grenzen](https://www.redakteuse.de/2009/09/23/task-grenzen/) - Beim Texten von Tasks gibt es etwas, was mich als Redakteur von Software-Doku seit den Anfangstagen als TR regelmäßig verrückt macht: wo hört ein Task auf und wo beginnt der nächste? Speziell bei Handlungen, die im Großen und Ganzen dasselbe Ziel haben, aber die man auf verschiedenen Wegen erreichen kann. 1 Handlung = mehrere Varianten - [Sollen wir uns ums Drucken drücken?](https://www.redakteuse.de/2009/09/22/sollen-wir-uns-ums-drucken-drucken/) - Es ist dieser Satz, den man als Redakteur echt hasst: Liest das überhaupt jemand? Etwas überzogen könnte man antworten: Ja, ich hoffe es. ich weiß es nicht, aber ich hoffe es. Und falls dem nicht so ist, so soll bitte niemand eine Möglichkeit erfinden das nachzuprüfen, vielleicht werden wir sonst alle abgeschafft. Und das wäre - [Kosten-Nutzen... und der Nutzer](https://www.redakteuse.de/2009/08/11/kosten-nutzen-und-der-nutzer/) - Sarah O'Keefe hat unlängst folgenden Satz getwittert: "Single sourcing can privilege organization needs over end user needs" Das hat mich an die Zeit erinnert, als ich im Studium die Standardisierung in der Dokumentation kennenlernte. Es wurde einem beigebracht, dass das total toll für den Nutzer ist, weil alles viel eindeutiger ist und damit verständlicher. Mein - [Breadcrumbs in DITA-XHTML](https://www.redakteuse.de/2009/07/20/breadcrumbs-in-dita-xhtml/) - Der Name Breadcrumb-Navigation wurde in Anlehnung an das Märchen Hänsel und Gretel der Brüder Grimm gebildet, in dem die in den Wald geführten Kinder Brotkrumen (englisch breadcrumbs, plurale tantum) auf den Weg streuen, um den Weg zurück zu finden (PediaWiki) Mir geht es speziell um die "Location-Breadcrumbs", d.h. ich möchte, dass in meiner HTML-Hilfe sichtbar - [Firefox & seine html.css](https://www.redakteuse.de/2009/07/15/firefox-seine-htmlcss/) - Ich bin gerade dabei meine DITA-HTML-Hilfe zu stylen. Da es lediglich um Aufhübschen ohne große Effekte geht, reaktiviere ich also meine HTML & CSS-Fähigkeiten. Eben hat mich aber eine Sache zum Wahnsinn gebracht, von der ich echt überrascht bin, dass ich sie noch nie bemerkt habe. Denn ich habe schon durchaus einige Zeit beim Webseiten-Bauen - [tekom-Tagung 2009](https://www.redakteuse.de/2009/07/15/tekom-tagung-2009/) - Gerade kam ein Newsletter hereinspaziert und berichtete mir vom Programm der tekom-Tagung 2009. Beim Überfliegen des Programms hat sich erst einmal ein positiver Eindruck eingestellt. Mir kam es vor, als ob nun verstärkt auf "Experten / Fortgeschrittenen"-Vorträge gesetzt wird. Letztes Jahr war das meiner Meinung nach noch nicht so. Interessant fand ich auch, dass auch - [Wiederverwendbarkeit von Maps & Cross-Media-Publishing](https://www.redakteuse.de/2009/06/22/wiederverwendbarkeit-von-maps-cross-media-publishing/) - Neben dem Single-Source-Publishing (aus einer Quelle baue unterschiedliche Dokumente, z.B. Admin-Handbuch und User-Quickstart) ist auch Cross-Media-Publishing ein wichtiges Schlagwort in der heutigen TR (aus einem Dokument baue verschiedene Outputs, z.B. PDF, HTML und CHM). Beide Prinzipien finden sich auch in DITA wieder. Maps in DITA wiederverwenden Man kann in DITA ganze Maps wiederverwenden. Hierzu muss - [Und es hat Bing gemacht!](https://www.redakteuse.de/2009/06/18/und-es-hat-bing-gemacht/) - Mich hat der Hype um Microsofts neue Suchmaschine Bing relativ kalt gelassen, weil...naja, seien wir mal ehrlich... wann hat einen zuletzt was aus diesem Softwarehause schon groß umgeworfen? Nun mehren sich die Meldungen, dass der Marktanteil steigt und ich musste nun doch mal kurz reinschnuppern. Erster Eindruck Die Startseite ist aufgeräumt und ein bisschen bunter - [Links in DITA #3 - Relationship tables](https://www.redakteuse.de/2009/06/09/links-in-dita-3-relationship-tables/) - Mit den so genannten Relationship tables (reltable) kann man die Beziehungen zwischen Topics definieren. Hiermit implementiert man Verlinkungen, die nicht durch die Hierarchie (oder die anderen collection-types) festgelegt ist. Wie sieht das aus? Jede Zeile in der Tabelle repräsentiert einen Zusammenschluss von Beziehungen der darin verlinkten Topics: In diesem Fall lege ich fest, dass bis - [Bedingter Text in der Praxis](https://www.redakteuse.de/2009/06/02/bedingter-text-in-der-praxis/) - Oder nennen wir ihn auch "conditional text". Gemeint ist das Prinzip Texte mit einem Attributwert zu versehen und beim Generieren festzulegen, ob Elemente mit diesem Attribut inkludiert oder exkludiert werden. Eigentlich eine feine Sache, um Produktvarianten zu handhaben (So geht es in XMetal). Praxisbeispiel Nun wende ich das ganze wirklich zum ersten Mal an und - [Links in DITA #2 - Hierarchien und collection-type](https://www.redakteuse.de/2009/05/27/links-in-dita-2-hierarchien-und-collection-type/) - Ich habe bereits vorgestellt, welche Möglichkeiten des manuellen Verlinkens es gibt. Wie gesagt, erschwert diese Methodik die Wiederverwendung eines Texts. Da Wiederverwendung jedoch einer der Kernpunkte von DITA ist, gibt es natürlich auch hier Mittel und Wege. Und zwar indem man die Verlinkungregeln in die Maps auslagert. So kann man auch nur das verlinken, was in - [Spezialisierung: Eigene DITA-Attribute definieren](https://www.redakteuse.de/2009/05/26/spezialisierung-eigene-dita-attribute-definieren/) - DITA bietet bereits einige Attribute, die schon sehr viele wichtige Dinge in der technischen Dokumentation abdecken: product, audience, platform seien da als Beispiele genannt. Wenn es um sehr firmenspezifische Dinge geht, benötigt man hier schnell eigene Attribute. Für mich persönlich sehr wichtig, sind auch vorgegebene Attributwerte, weil eine vorgegebene Auswahl immer sehr viel weniger fehleranfällig - [Rätsel zum Freitag](https://www.redakteuse.de/2009/05/15/ratsel-zum-freitag/) - Ich bin ja keine Übersetzerin und mein Englisch-LK ist auch ne Weile her, aber diese externe Übersetzung meines deutschen Hilfetexts in das Englische hat mich stutzig gemacht. Die Auflösung kommt nach dem nächsten Klick! :) Und ja, Schriftfarbe und - größe wurden jeweils mit script colour und script size übersetzt. Aua... - [Links in DITA #1](https://www.redakteuse.de/2009/05/14/links-in-dita-1/) - Der Link ist essentieller Bestandteil der Online-Welt. Gerade bei der Topicorientierung, in der Information quasi auseinandergerissen ist, ist er die beste Navigationsmöglichkeit für den Leser und stellt einen Kontext her. DITA ermöglicht einem einerseits manuell Links zu setzen oder sie automatisiert setzen zu lassen, indem man vorher den Beziehungsstatus definiert. Heute gibt es erst einmal - [IBM Task Modeler: die Anfänge einer Dokumentation](https://www.redakteuse.de/2009/05/13/ibm-task-modeler-die-anfange-einer-dokumentation/) - Ich bin in den letzten Monaten mehr land unter als mir lieb ist und man sieht doch eindeutig an der Zahl meiner Blogeinträge, dass ich nach Feierabend kaum noch Energie für TR abseits meiner Arbeit aufbringe. Dabei habe ich doch gerade in dieser arbeitsreichen Zeit wieder einigen Stoff gesammelt :) Tasks konzipieren jeder Schreiber kennt - [Technische Redaktion in der Politik](https://www.redakteuse.de/2009/05/12/technische-redaktion-in-der-politik/) - Was hören denn da meine Ohren im Autoradio? Die Worte Frau Merkel und Gebrauchsanweisungen in einem Satz. Moooment! Ich persönlich – das mag mit dem zunehmenden Alter zusammenhängen – stelle immer wieder fest, dass Gebrauchsanleitungen für technische Geräte oft sehr schwierig zu verstehen sind. Ich habe immerhin Physik studiert und denke mir, dass ich nicht ganz ungebildet - [So geht's... wahrscheinlich!](https://www.redakteuse.de/2009/05/03/so-gehts-wahrscheinlich/) - Ja, mein Sonntag ist heute teilweise von dem Papierhaufen auf meinem Schreibtisch geprägt, der mich seit einiger Zeit mahnend anwackelt. Und da die Steuererklärung hierzulande noch nicht auf den Bierdeckel passt, ist also Google mein Freund - und das ELSTER-Anwenderforum. Naja, die Leute sind zumindest gewillt mir zu helfen, auch wenn sie selbst nicht immer - [Schreib's noch einmal, Sam!](https://www.redakteuse.de/2009/04/28/schreibs-noch-einmal-sam/) - In Jacob Nielsens aktueller Kolumne kann man lesen, was für tolle Überschriften man doch auf BBC findet und wie super "web-usable" diese doch sind. [...] Web headlines, which must be: short (because people don't read muchonline); rich in information scent, clearly summarizing the target article; front-loaded with the most important keywords (because users often scan - [Imagefilm - Technischer Redakteur](https://www.redakteuse.de/2009/03/30/imagefilm-technischer-redakteur/) - Die tekom scheint gerade voll durchzustarten, was das Werben von Nachwuchs angeht. Hier findet ihr einen Imagefilm: Und jetzt das ganze noch bei youtube hochladen, liebe tekom, und ihr seid völlig WebZwoNull. Wenn schon "Medienberuf", dann aber richtig Jetzt auch bei youtube ;) Und ich find den Film eigentlich gar nicht schlecht, wobei ich mich - [DITA und XMetal](https://www.redakteuse.de/2009/03/19/dita-und-xmetal/) - Und jetzt erst finde ich diese Präsentation von Simon Bate (Scriptorium)! Meine Güte, da hätte ich mir einiges an nerviger Recherche sparen können. Aber ich will mein Wissen natürlich brav weitergeben: also holt euch Popcorn, was zu schreiben und stellt das Radio aus. Hier wird es wirklich interessant und praxisbezogen :) XMetaL DITA Workshop View - [Spaß, Spaß... wir wollen Spaß!](https://www.redakteuse.de/2009/03/19/spas-spas-wir-wollen-spas/) - Es ist wahr, was man so oft sagt: zwingt man sich erst einmal wieder zum Schreiben, fallen einem schon tausende Sachen ein, die man bloggen will :) Die Kollegen vom Joomla-Buch haben einen Blogpost zum Thema Humor in der technischen Doku gemacht. Den Ansatz finde ich recht interessant, wobei mir ganz persönlich hier noch gute - [DITA-Output filtern mit XMetal](https://www.redakteuse.de/2009/03/18/dita-output-filtern-mit-xmetal/) - Wiederverwendung und Varianten Das Filtern wird in Zeiten der Wiederverwendung früher oder später notwendig. Man hat beispielsweise ein Produkt, dass es in einer Light-Version und einer Vollversion gibt. Natürlich werden sich hier die Hilfetexte zum größten Teil überschneiden - bis auf die kleinen Ausnahmen, wo dann in der Vollversion hier noch ein Schritt weniger ist - [Gelesen: DITA - Der neue Standard für technische Dokumentation](https://www.redakteuse.de/2009/03/18/gelesen-dita-der-neue-standard-fur-technische-dokumentation/) - Bisher sind die Informationsquellen bzw. die Literatur zu DITA eher rar, im Endeffekt bleibt man beim User-Guide und der Yahoo-Group hängen und sammelt sich dort alles irgendwie zusammen. Nun bin ich endlich dazu gekommen mir das erste deutschsprachige Buch rund um DITA zu bestellen und zu lesen: DITA - Der neue Standard für technische Dokumentation - [Realitätscheck](https://www.redakteuse.de/2009/03/17/realitatscheck/) - Der Dilbert von gestern hat mich an das erinnert, was ich einst als schmerzlichen Bruch zwischen der idealen Welt an der Hochschule und der realen Welt im Arbeitsalltag erfahren musste. Auf der einen Seite lernt man, wie bspw. ein idealer Entwicklungsprozess aussieht, von der Konzeption über die Entwicklung bis hin zur Dokumentation. Auf der anderen - [Was soll ich schreiben?](https://www.redakteuse.de/2009/03/06/was-soll-ich-schreiben/) - Hey, als technischer Redakteur ist das doch eine einfache Frage: "Dokumentier halt, was man mit dem Produkt machen kann und was man nicht machen sollte." Soso... "Dazu braucht man doch keine Hilfe!" Ich habe gerade das erste Mal nach langer Zeit mal wieder ganz von Grund auf Hilfe zu einem neuen Produkt geschrieben. Und zwar - [Membrane](https://www.redakteuse.de/2009/02/19/membrane/) - Nachdem ich bei den Kollegen von manualBLOG allerlei Lustiges rund um Lokalisierung/Übersetzung gelesen habe, muss ich einfach mal meinen alten Schatz zeigen. Ich habe vor Jahren einmal eine sehr, sehr, sehr billige Tastatur erworben. Nach dem Auspacken stellte ich fest, dass sie wirklich billig war und beschloss sie wieder einzupacken und umzutauschen. Dabei stach mir - [Maschinenherrschaft](https://www.redakteuse.de/2009/02/13/maschinenherrschaft/) - Als technischer Redakteur muss man sich eh immer die Witze über die vom Chinesischen ins Deutsche übersetzten Anleitungen anhören. Dem halte ich dann immer entgegen, dass das inzwischen bei professionellen Firmen voll toll abläuft. Man hat Translation Memories, Terminologien, standardiertes Schreiben und all sowas. wird falsch dem da Sein Und dann kommt Microsoft® und knallt - [Standardisieren ohne Kopf](https://www.redakteuse.de/2009/02/11/standardisieren-ohne-kopf/) - Wenn man sehr viel schreibt, passiert es gut und gerne, dass man sich bestimmte Schreibmuster angewöhnt ohne darüber nachzudenken. Sehr beliebt sind bei mir Füllwörter jeder Art, die ich bei meiner Master-Thesis am Ende per Strg+F suchen konnte, weil es zur der Zeit immer die dieselben zwei waren ;) Ansonsten sind Schreibmuster für einen technischen - [Firebug - neu entdeckt](https://www.redakteuse.de/2009/01/22/firebug-neu-entdeckt/) - Ich habe ja schon einmal über den Nutzen von Firebug für Screenshots erzählt. Und schon wieder habe ich ein nützliches Feature entdeckt, auf das ich bisher einfach noch nie geklickt hatte, das aber insbesondere für die Webentwicklung extrem praktisch ist. Denn beim Layouten hat man oft das Problem, dass sich die CSS-Definitionen für padding oder - [DITA-Referenz in der Praxis: shortdesc vs context](https://www.redakteuse.de/2009/01/20/dita-referenz-in-der-praxis-shortdesc-vs-context/) - Wenn man mit DITA anfängt, hat man zuerst das Gefühl: "Wow, ich muss nichts mehr selbst erfinden. Alles ist schon da! Woohooo!" Kaum schreibt man ein bisschen länger, stellt man fest, dass es immer wieder Fälle gibt, in denen die DITA-Referenz nicht so eindeutig ist, wie man sich das wünscht Ich habe mich beospielsweise immer - [XHTML-Output anpassen #2 - Wie mache ich einen Override?](https://www.redakteuse.de/2009/01/15/xhtml-output-anpassen-2-wie-mache-ich-einen-override/) - Ich habe nun damit angefangen Anpassungen vorzunehmen. Im Groben sind dazu folgende Schritte notwendig: Plugin-Verzeichnis und Dateien anlegen. Plugin integrieren. XSL anpassen. Plugin-Verzeichnis und Dateien anlegen Dazu habe ich unter DITA_OT/demo ein Verzeichnis meinxhtml für meine Overrides angelegt, d.h. hier liegen meine Anpassungen für den XHTML-Output. Für DITA ist das einfach ein Plugin. In diesem - [Meine liebsten Tools](https://www.redakteuse.de/2009/01/09/meine-liebsten-tools/) - Ich bin immer wieder höchst entzückt, wenn ich irgendwo ein Programm entdecke, dass mir die Arbeit wirklich erleichtert. Der Vorteil an einem IT-Unternehmen liegt darin, dass man solche Sachen gerne mal zufällig beim Kollegen oder der Kollegin entdecken kann. Ich liebe Open-Source. Meistens. Daher habe ich gedacht, poste ich einfach mal eine Liste meiner unverzichtbaren - [Kenne deinen Nutzer](https://www.redakteuse.de/2009/01/08/kenne-deinen-nutzer/) - Es ist wohl DAS Mantra, wenn es um gute Produkte geht. Jeder unterschreibt sofort, dass man erst einmal wissen muss für WEN man etwas produziert, bevor man beginnt es zu produzieren. Gleichzeitig steht jeder vor dem Problem, dass es schwierig ist, herauszubekommen, was Nutzer wirklich wollen. Was wollten Sie schon immer mal mit meinem Produkt - [DITA-Texte anpassen](https://www.redakteuse.de/2008/12/17/dita-texte-anpassen/) - Ja, die Zeit der Anpassung ist da ;) Mit dem OT kommt ja schon ein Satz an Texten mit Übersetzungen mit. Natürlich passen einem da so manche Texte nicht wirklich und man möchte sie ändern. Oder man möchte vielleicht noch Texte hinzufügen, so wie ich einen umfangreichen, firmenspezifischen Copyright-Text. Ich habe hier bisher in der - [Verbessern Sie Ihr Leben jetzt!](https://www.redakteuse.de/2008/12/11/verbessern-sie-ihr-leben-jetzt/) - Klingt ja fast schon wie Spam: Your life just got better. Not in big ways. Your social life isn't going to be helped, though with any luck you may now have more time for one. Quelle: welcome.html der apache-ant-Installatiion Die Zielgruppe ist ja wohl eindeutig. Immer diese Klischees, dass Entwickler kein soziales Leben haben... ;) - [XHTML-Output anpassen](https://www.redakteuse.de/2008/12/10/xhtml-output-anpassen/) - Jeder, der mit DITA anfängt, kommt schnell an dem Punkt an dem er das starke Bedürfnis hat, den Output an das eigene Layout anzupassen. Die Standardlayouts im OT sind, sagen wir mal, sehr nüchtern oder auch eher 0.5 als 2.0 ;) Und in einer Firma will man natürlich Logos und allerlei Schnick-schnack einbauen. So, und - [Logfiles in XMetal - Nachtrag](https://www.redakteuse.de/2008/12/09/logfiles-in-xmetal-nachtrag/) - Einen kleinen Haken hat die Angelegenheit! Man sollte nicht aus Versehen das Verzeichnis löschen, das man als Logfile-Verzeichnis angegeben hat. Sonst bekommt man nämlich diese vielsagende Fehlermeldung beim Generieren! Tja, ich wusste durch diese Meldung zwar, dass irgendetwas nicht gefunden wurde, aber was?! Nachdem ich mir anschaute, welche Verzeichnisse ich kurz vorher "aufgeräumt" hatte, wusste - [Logfiles in XMetal](https://www.redakteuse.de/2008/12/09/logfiles-in-xmetal/) - Ich weiß nicht wie es anderen geht, aber bei meiner XMetal-Installation schlägt es fehl, wenn ich mir die die Output Logs anschauen will: There is no valid logfile. Ganz beliebt, wenn das Generieren gerade nicht geklappt hat und man gerne auf Fehlersuche gehen würde - grummel! Wenn man sich dann eine Weile auf die Suche - [Was kann man mit technischer Redaktion anfangen?](https://www.redakteuse.de/2008/12/02/was-kann-man-mit-technischer-redaktion-anfangen/) - So lautete eine Google-Anfrage, die schließlich zu meinem Blog führte... *g* Tja, ich würde sagen, man kann einiges damit anfangen: zum Beispiel studieren und einen Master und Bachelor als technischer Redakteur machen ;) Und außerdem ist das Jobangebot in diesem Berufszweig gerade nicht das schlechteste, was ja schon einmal ein guter Ansporn sein kann. - [Ordnung muss sein #2 - SubVersion](https://www.redakteuse.de/2008/11/27/ordnung-muss-sein-2-subversion/) - So, ich habe nun eine tolle Ordnerstruktur. Beim Schreiben mit DITA produziert man viele, viele Topics, also ganz viele einzelne Dateien. Diese Arbeitsweise ist geradezu prädestiniert dazu, die Arbeit auf mehrere Redakteursschultern zu verteilen. Tja, und was sagt man gerne über viele Köche und ihren Brei? Ja, man muss die Zusammenarbeit irgendwie steuerbar und kontrollierbar - [Ordnung muss sein #1](https://www.redakteuse.de/2008/11/26/ordnung-muss-sein-1/) - So lange man ohne CMS arbeitet, muss man auf die gute alte Ordnerstruktur zugreifen, um seine Dateien abzulegen. Einerseits bietet DITA einem natürlich einen Haufen toller Attribute mit denen man seine Topics filtern kann, andererseits kann man damit auf Dateisystemebene erst einmal nicht so viel anfangen. Wieviel Ordnung brauchen wir? Mit Ordnern neigt man gerne - [Kreatives Schreiben](https://www.redakteuse.de/2008/11/21/kreatives-schreiben/) - Auf Tom Johnsons Blog gibt es gerade einen guten Artikel zum Thema "Vom Literaturstudium zur Technischen Redaktion", den ich so ziemlich unterschreiben kann :) Von der Goethe-Bibliographie zum Software-Handbuch Wie schon früher erwähnt komme ich ja ursprünglich von der Germanistik und bin absolut überzeugt, dass ein solcher Hintergrund bestens auf die Dokumentation vorbereitet. Und zwar - [topichead, topicref - Konfusion](https://www.redakteuse.de/2008/11/18/topichead-topicref-konfusion/) - Das Problem mit der Strukturierung, das ich unlängst hatte, ist tatsächlich nicht so einfach zu lösen. Kurzzusammenfassung: Es ging darum zwei Unterkapitel in einem Oberkapitel zusammenzufassen, das selbst aber eigentlich keinen Inhalt enthält. title-only topics Es gibt einerseits den Ansatz sog. title-only Topics zu benutzen, die lediglich den Titel und eine short description enthalten. Damit - [Denn sie wissen nicht, was sie wollen](https://www.redakteuse.de/2008/11/17/denn-sie-wissen-nicht-was-sie-wollen/) - Hatte ich bei diesem Usability-Vortrag noch gehört, dass User oft Dinge wollen, von denen sie selbst nichts wissen, stolpere ich doch heute glatt über einen uralten Artikel bei Jacob Nielsen: First Rule of Usability? Don't Listen to Users Feedback vom User ist wohl so ziemlich für alle Redakteure schwarzes Loch. Was wollen die eigentlich? Wie - [tekom-Jahrestagung 2008 #5 - Finale](https://www.redakteuse.de/2008/11/16/tekom-jahrestagung-2008-5-finale/) - Ich habe einen Haufen Vorträge gesehen und nachdem ich nun meine Highlights schon beschrieben habe, kommen wir zu der Kategorie "Ferner liefen...". Hier findet sich sowohl Gutes als auch Schlechtes ;) Adobe Air, eine neue Basis für Onlinehilfen? Der erste Vortrag meines Tagungsprogramms lieferte einen gute Überblick über das was Air ist, was es kann - [tekom-Jahrestagung 2008 #4](https://www.redakteuse.de/2008/11/16/tekom-jahrestagung-2008-4/) - Sarah O'Keefe: The Implications of Web 2.0 for Technical Communicators Hm, noch ein Web 2.0-Vortrag? Ich hatte mehrfach gehört, dass Sarah gute Vorträge hält, also habe ich in Kauf genommen eventuell wieder zu hören, was ein Wiki oder Podcast ist ;) Erfreulicherweise ging der Vortrag aber wirklich auch in die Richtung, wie wir als Redakteure - [Neuer Header](https://www.redakteuse.de/2008/11/15/neuer-header/) - Da soll noch einmal einer sagen, dass Designen so einfach ist... Für diesen neuen Header hab ich nun 1,5h gebraucht. Wobei man allerdings sagen muss, dass die meiste Zeit dafür draufging, andere Ideen zu verwerfen ;) - [Schmuck für Redakteure](https://www.redakteuse.de/2008/11/15/schmuck-fur-redakteure/) - Auf was man beim Designen des Layouts so stößt, ist doch der Knüller. Das Help Key Necklace: Und nein, ich will's wirklich nicht zu Weihnachten :) - [tekom-Jahrestagung 2008 #3](https://www.redakteuse.de/2008/11/11/tekom-jahrestagung-2008-3/) - Translation Reuse Strategies von Hans Pich Eigentlich wollte ich in den Vortrag zu DITA, XLIFF und Co., aber irgendwie bin ich durcheinander gekommen, aber thematisch war auch dieser Vortrag durchaus auch nicht verkehrt ;) Zuerst hatte ich erwartet, dass einfach wieder über den tollen Einsatz von TMS und blablabla erzählt wird. Der Ansatz von Herrn - [tekom-Jahrestagung 2008 #2](https://www.redakteuse.de/2008/11/11/tekom-jahrestagung-2008-2/) - Was User lieben, was sie hassen von Peter Hogenkamp (Zeix AG) Dieser Vortrag war sehr gut besucht - und das zu Recht. Peter startete den Vortrag mit einer Anekdote darüber, dass er auf dem Weg zur Tagung verzweifelt versuchte die Uhr seines Mietwagens auf Winterzeit zu stellen. Dumm nur, dass Toyota sich bei diesem Auto - [tekom-Jahrestagung 2008 #1](https://www.redakteuse.de/2008/11/09/tekom-jahrestagung-2008-1/) - So, drei anstrengende Tage liegen hinter mir... Ich weiß gar nicht wo ich eigentlich am besten anfangen soll... Deswegen fang ich mal mit Vorträgen an, die ich besonders gut fand. Analyzing User Assistance Deliverables: Developing Your Optimum Documentation Library - Nicoletta Bleiel Das Hauptaugenmerk des Workshops lag auf den verschiedenen Arten von Hilfepublikationen. Der Titel - [DITA und Wikis](https://www.redakteuse.de/2008/10/27/dita-und-wikis/) - Ich bin Wiki-Fan. Ich bin DITA-Fan. Bei beidem geht es um Topics. Hmm... Ist doch klar, dass DITA2Wiki mir den Mund wässrig macht. Es ist zwar nur eine Beta, aber DAS würde ich wirklich sehr gerne ausprobieren. Seufz... - [tekom-Jahrestagung 2008](https://www.redakteuse.de/2008/10/20/tekom-jahrestagung-2008/) - Ich bin schon gespannt wie ein Flitzebogen. Erstens war ich noch nie bei der Tagung (für meinen ersten Job war das nicht so relevant und als Student hatte ich für solche Sperenzchen kein Geld und keine Zeit). Zweitens trifft das Programm derart meinen Nerv, dass ich vermutlich Probleme haben werde mich zu entscheiden, wo ich - [Was war zuerst: die Struktur oder das Topic?](https://www.redakteuse.de/2008/10/14/was-war-zuerst-die-struktur-oder-das-topic/) - Für die technische Doku bin ich nun ein absoluter Anhänger der Topicorientierung. Der Anspruch ist hier nicht für eine bestimmte Ausgabe zu schreiben, sondern die Bedienung eines Produkt zu beschreiben und ggf. die Hintergrundinformationen, die man dazu benötigt. Aus diesen Beschreibungen kann man sich später die verschiedensten Dokumentypen zusammenbauen, vom Schnell-Start-Guide bis zum Kompletthandbuch. Nun - [Und bei welcher Zeitung bist du?](https://www.redakteuse.de/2008/10/09/und-bei-welcher-zeitung-bist-du/) - Party-Small-talk kommt immer irgendwie zu der Frage: "Und was machst du so?". Schon als Germanistikstudentin war das für mich der wahnsinnig nervige Punkt einer Konverstaion, weil auf meine Antwort, dass ich eben Germanistik studiere, das Gespräch in Richtung Arbeitslosgkeit und Sinnhaftigkeit eines solchen Studiengangs ging. Super! Aber es sollte noch schlimmer kommen: nämlich als ich - [Links auf Online-PDFs](https://www.redakteuse.de/2008/10/07/links-auf-online-pdfs/) - Heute: ein großartiger Fehler! Ich habe in meinem Topic einen Link auf ein PDF im Internet gesetzt. User Guide Im HTML-Output hat der Link auch super funktioniert, ABER im PDF-Output hat der Link nicht funktioniert. Aaah! Ich ahnte Böses in die Richtung, dass ich hier schon wieder geFOPpt werde und damit erst - [Topics strukturieren](https://www.redakteuse.de/2008/10/06/topics-strukturieren/) - Eine typische Doku-Situation geht so: Man hat zwei Kapitel, die inhaltlich unter einen Oberkapitel passen und um die Struktur übersichtlicher zu machen, packt man die Zweikapitel mit ihren Überschriften unter eine Ober-Überschrift (siehe unten). 1 Installation 1.1 blubTunes installieren So installieren Sie...bla 1.2 blobTunes installieren So installieren Sie... Ein Problem stellt sich mir aber dar, - [Topic-Orientierung](https://www.redakteuse.de/2008/10/05/topic-orientierung/) - Das Topic Ein Wort, das nun spätestens seit DITA eingeschlagen ist wie eine Bombe und in vieler Munde ist. In der Welt der Software-Hilfen ist das Topic an und für sich schon länger präsent, da dort die Hilfe in Form von Einzelartikeln präsentiert wird. Oftmals wurde hier aber nicht topic-orientiert geschrieben, sondern eben wirklich nur - [Screenshots ändern leicht gemacht](https://www.redakteuse.de/2008/09/29/screenshots-andern-leicht-gemacht/) - Jeder Redakteur für web-basierte Software kennt das Problem, dass die Software, die man zum Doku schreiben benutzt, oft etwas anzeigt, was der Kunde in der Doku so nicht sehen soll. Zum Beispiel steht irgendwo noch "Beta-Version" im Text oder es werden Testdaten angezeigt ("Sie sind als Test Testosteron eingeloggt."). Man macht also einen Screenshot und - [Lokalisieren mit DITA](https://www.redakteuse.de/2008/09/28/lokalisieren-mit-dita/) - Eigentlich ist es eine ganz einfache Sache bei DITA: man setzt xml:lang-Attribut auf die gewünschte Sprache/Sprachvariante und zack, sind die Standardtexte (so etwas wie "Achtung", "Voraussetzung" u.ä.) lokalisiert. DITA bringt schon eine ganze Latte von Sprachdateien mit sich, die diese Texte enthalten und zwar unter DITA_OT/xsl/common. Nun habe ich diese Dateien erweitert und das hat - [GeFOPpt](https://www.redakteuse.de/2008/09/24/gefoppt/) - Wir befinden uns mit DITA noch in einer Pilotphase, d.h. das ganze muss erst einmal so wenig wie möglich kosten, weil man ja nicht weiß, ob der Weg vielleicht doch nicht der Richtige ist. Das heißt also wir nutzen einfach das, was im Open Tool Kit mitgeliefert wird. Beim PDF-Output hat sich aber ein Layoutmangel - [Darwin's Kartoffeln](https://www.redakteuse.de/2008/09/22/darwins-kartoffeln/) - Da verarbeite ich doch gerade die Kartoffeln zum Mittagessen, als mir da was auffällt... Die Arbeit lässt einen auch nie in Ruhe! - [Kurzer Prolog](https://www.redakteuse.de/2008/09/22/kurzer-prolog/) - Beweggründe dieses Blog zu beginnen Ich bin eine begeisterte Anhängerin davon mein (Un-)Wissen zu teilen und das werde ich hier tun. Und zwar erst einmal aus völligem Eigennutz. Ich befinde mich gerade in einer megaspannenden Phase bei der ich viel Neuland betreten werde. Einige dieser Erfahrungen werde ich hier preisgeben, damit ich das ganze nicht ## Seiten - [Vorträge - Marijana Prusina](https://www.redakteuse.de/downloads/) - Vortragsfolien von Marijana Prusina zum Download. tekom-Jahrestagung, tekom Regionalgruppe... - [Über mich - Marijana Prusina](https://www.redakteuse.de/uber-mich/) - Marijana Prusina ist freiberufliche Expertin für Technische Dokumentation in der IT. Als Redakteuse bloggt sie über alles Mögliche aus dem Redaktions-Alltag. - [Beispiel-Seite](https://www.redakteuse.de/beispiel-seite/) - Dies ist eine Beispiel-Seite. Sie unterscheidet sich von Beiträgen, da sie stets an derselben Stelle bleibt und (bei den meisten Themes) in der Website-Navigation angezeigt wird. Die meisten starten mit einem Impressum, der Datenschutzerklärung oder einer „Über uns“-Seite, um sich potenziellen Besuchern der Website vorzustellen. Dort könnte zum Beispiel stehen: Hallo! Tagsüber arbeite ich als Fahrradkurier, - [Impressum & Datenschutz](https://www.redakteuse.de/impressum-2/) - mp dokumentation Marijana Prusina, M.Sc. Mobil: 0163-7181866 E-Mail: mp@mp-dokumentation.de Adresse: Sophienstraße 89, 76135 Karlsruhe Umsatzsteuer-Identifikationsnummer gemäß § 27 a Umsatzsteuergesetz: DE 278 946 210 Haftungsausschluss 1. Inhalt des Onlineangebotes Der Autor übernimmt keinerlei Gewähr für die Aktualität, Korrektheit, Vollständigkeit oder Qualität der bereitgestellten Informationen. Haftungsansprüche gegen den Autor, welche sich auf Schäden materieller oder ideeller Art ## Kategorien - [Allgemein](https://www.redakteuse.de/category/allgemein/) - [Beruf](https://www.redakteuse.de/category/beruf/) - [DITA](https://www.redakteuse.de/category/dita/) - [Erweiterter Horizont](https://www.redakteuse.de/category/erweiterter-horizont/) - [Nice to know](https://www.redakteuse.de/category/nice-to-know/) - [Redakteurs Alltag](https://www.redakteuse.de/category/redakteurs-alltag/) - [Social Media](https://www.redakteuse.de/category/social-media/) - [Softwaredokumentation](https://www.redakteuse.de/category/softwaredokumentation/) - [Übersetzung](https://www.redakteuse.de/category/ubersetzung/) - [Usability](https://www.redakteuse.de/category/usability/) - [Lokalisierung](https://www.redakteuse.de/category/ubersetzung/lokalisierung-ubersetzung/) ## Schlagwörter - [Arrgh](https://www.redakteuse.de/tag/arrgh/) - [barcamp](https://www.redakteuse.de/tag/barcamp/) - [Bibliothek](https://www.redakteuse.de/tag/bibliothek/) - [CMS](https://www.redakteuse.de/tag/cms/) - [Content Strategy](https://www.redakteuse.de/tag/content-strategy/) - [CSS](https://www.redakteuse.de/tag/css/) - [DITA](https://www.redakteuse.de/tag/dita/) - [Druck](https://www.redakteuse.de/tag/druck/) - [Embedded help](https://www.redakteuse.de/tag/embedded-help/) - [Feedback](https://www.redakteuse.de/tag/feedback/) - [firefox](https://www.redakteuse.de/tag/firefox/) - [FOP](https://www.redakteuse.de/tag/fop/) - [Fortbildung](https://www.redakteuse.de/tag/fortbildung/) - [Fun](https://www.redakteuse.de/tag/fun/) - [Google](https://www.redakteuse.de/tag/google/) - [GUI](https://www.redakteuse.de/tag/gui/) - [how-to](https://www.redakteuse.de/tag/how-to/) - [HTML](https://www.redakteuse.de/tag/html/) - [iak](https://www.redakteuse.de/tag/iak/) - [IBM](https://www.redakteuse.de/tag/ibm/) - [Informationsarchitektur](https://www.redakteuse.de/tag/informationsarchitektur/) - [Konferenz](https://www.redakteuse.de/tag/konferenz/) - [Kontexthilfe](https://www.redakteuse.de/tag/kontexthilfe/) - [Lessons learned](https://www.redakteuse.de/tag/lessons-learned/) - [Links](https://www.redakteuse.de/tag/links/) - [live](https://www.redakteuse.de/tag/live/) - [Lokalisierung](https://www.redakteuse.de/tag/lokalisierung/) - [Maschinelle Übersetzung](https://www.redakteuse.de/tag/maschinelle-ubersetzung/) - [Microsoft](https://www.redakteuse.de/tag/microsoft/) - [Mobile](https://www.redakteuse.de/tag/mobile/) - [Nutzer](https://www.redakteuse.de/tag/nutzer/) - [Öffentlichkeit](https://www.redakteuse.de/tag/offentlichkeit/) - [Open Toolkit](https://www.redakteuse.de/tag/open-toolkit/) - [Organisation ist alles](https://www.redakteuse.de/tag/organisation-ist-alles/) - [Output](https://www.redakteuse.de/tag/output/) - [Philosophie](https://www.redakteuse.de/tag/philosophie/) - [PI-Mod](https://www.redakteuse.de/tag/pi-mod/) - [Reuse](https://www.redakteuse.de/tag/reuse/) - [Schreiben](https://www.redakteuse.de/tag/schreiben/) - [Selbstreferenziert](https://www.redakteuse.de/tag/selbstreferenziert/) - [Software](https://www.redakteuse.de/tag/software/) - [Softwarelokalisierung](https://www.redakteuse.de/tag/softwarelokalisierung/) - [Sprache](https://www.redakteuse.de/tag/sprache/) - [Standardisierung](https://www.redakteuse.de/tag/standardisierung/) - [Studium](https://www.redakteuse.de/tag/studium/) - [Suche](https://www.redakteuse.de/tag/suche/) - [SVN](https://www.redakteuse.de/tag/svn/) - [tcworld](https://www.redakteuse.de/tag/tcworld/) - [Tech](https://www.redakteuse.de/tag/tech/) - [tekom](https://www.redakteuse.de/tag/tekom/) - [Terminologie](https://www.redakteuse.de/tag/terminologie/) - [Tipps](https://www.redakteuse.de/tag/tipps/) - [TMS](https://www.redakteuse.de/tag/tms/) - [Tools](https://www.redakteuse.de/tag/tools/) - [Topic-Orientierung](https://www.redakteuse.de/tag/topic-orientierung/) - [Training](https://www.redakteuse.de/tag/training/) - [Twitter](https://www.redakteuse.de/tag/twitter/) - [Usability](https://www.redakteuse.de/tag/usability/) - [User assistance](https://www.redakteuse.de/tag/user-assistance/) - [Variantenmanagement](https://www.redakteuse.de/tag/variantenmanagement/) - [Vortrag](https://www.redakteuse.de/tag/vortrag/) - [Wiederverwendung](https://www.redakteuse.de/tag/wiederverwendung/) - [Wiki](https://www.redakteuse.de/tag/wiki/) - [XHTML](https://www.redakteuse.de/tag/xhtml/) - [Zielgruppe](https://www.redakteuse.de/tag/zielgruppe/)