parson mit drei Beiträgen auf tekom-Jahrestagung 2014

Die weltweit größte Veranstaltung für technische Kommunikation, die Jahrestagung der tekom, findet vom 11. bis 13. November 2014 in Stuttgart statt. parson ist auch in diesem Jahr mit drei Beiträgen dabei.

Frank Ralf
Tutorial: Sonnenfinsternis in der Technischen Dokumentation

Wie bewegt man Entwickler, Dokumentation zu schreiben? Am besten, indem man sie in ihrer gewohnten (Entwicklungs-)Umgebung belässt. Eclipse ist eine integrierte Entwicklungsumgebung und bietet eine Reihe von Tools, die nicht nur Entwickler beim Erstellen von Softwaredokumentation unterstützen, sondern auch technischen Redakteuren die Arbeit erleichtern. In seinem Kurztutorial stellt Frank Ralf einige dieser Tools vor: Javadoc, Mylyn WikiText, IBM Information Architecture Workbench und oXygen.
 
Anhand konkreter Beispiele gibt Frank Ralf einen Überblick über Eclipse-Tools, die für die technische Dokumentation relevant sind. Technische Redakteure lernen diese Tools so weit kennen, dass sie entscheiden können, ob und wie sie die Tools in der Technischen Dokumentation verwenden können. Und sie können Entwicklern Tipps geben, wie sie Dokumentation ohne große Mühe in ihrer gewohnten Umgebung schreiben können. Denn je geringer der technische Aufwand, desto eher werden Entwickler bereit sein, Dokumentation zu schreiben.

Dienstag, 11. November, 16.15 - 18.00 Uhr
Zum Tagungsprogramm.
 
Mark Schubert und Frank Ralf
Workshop: DITA Diet – Beautiful on the Inside
 
DITA is huge. Not only regarding its impact in technical writing but also quite literally. The first time that someone new to DITA looks at the DITA specification they are probably overwhelmed by the sheer amount of elements. At least that was our experience. DITA 1.2 has over 500 elements, more than double the size of the first DITA version. That can make it difficult to move to DITA and also make it difficult for teams of technical writers to produce consistent output. In the worst case the complexity scares authors away or confuses them instead of providing guidance. That is why a lot of DITA authors use only a subset of the DITA standard. Such a subset can be defined by editing the DITA DTD.
 
In their workshop, Mark Schubert and Frank Ralf are going to take a closer look at the DITA DTD, its modular structure and methods of editing.
 
Mittwoch, 12. November, 11.15 - 13.00 Uhr
Zum Tagungsprogramm.

Ulrike Parson (parson) und Dr. Achim Steinacker (intelligent views)
Partnerpräsentation: Wer seine Dokumentation liebt, vernetzt sie
 
Semantische Netze repräsentieren Wissen, indem sie Objekte miteinander verknüpfen. In Unternehmen gibt es viele verschiedene Arten von Objekten, die zumeist in getrennten Systemen verwaltet werden: Produkte, Projekte, Mitarbeiter, Prozesse und vieles mehr. Ein semantisches Netz bringt diese Objekte in einen Zusammenhang: Es beschreibt die Eigenschaften der Objekte („ein Produkt hat eine Version“) und die Beziehungen zwischen den Objekten.
 
Anhand eines konkreten Projekts erläutern Ulrike Parson und Dr. Achim Steinacker, wie Informationen aus verschiedenen Unternehmensdatenbanken mithilfe eines semantischen Netzes integriert wurden. Parallel wurde die Entwicklerdokumentation auf DITA/XML umgestellt – eine wesentliche Voraussetzung für die Einbindung der Dokumentation in das Netz. Metadaten für die XML-Topics und -Maps wurden mit den Informationen angereichert, die für auswertbare Beziehungen im Netz sorgen.

Am Ende entstand ein semantisches Netz, das die Beziehungen zwischen Anforderungen, Testfällen, technischen Komponenten und Dokumentation visualisiert. Es ermöglicht individuelle Abfragen und Suchen, die die Rechte des jeweiligen Benutzers in den verschiedenen Systemen berücksichtigen. Der Zugriff erfolgt über ein Web-Portal, das häufig benötigte Informationen und Berichte komprimiert darstellt.

Mittwoch, 12. November, 12.15 - 13.00 Uhr
Zum Tagungsprogramm.

Hier finden Sie weitere Informationen über die tekom-Jahrestagung.

News

Wir suchen: Informationsarchitekt mit tiefem XML-Know-how für Hamburg (w/m)

Zwei Herzen schlagen in ihrer Brust? Denn Sie arbeiten sich nicht nur gerne intensiv in Informationsstrukturen und technische Themen ein, sondern haben ebenso viel Spaß daran, diese Themen anderen Menschen beratend zu vermitteln? mehr ...

Treffen Sie uns auf der tekom-Jahrestagung 2018

Die Jahrestagung findet vom 13. bis 15. November 2018 in Stuttgart statt. Unsere Themen: iiRDS, Software-Dokumentation und selbstführende Teams. mehr ...

Was gibt’s Neues bei iiRDS? Treffen Sie uns im iiRDS-Café.

Sie wollen mehr über iiRDS erfahren? Kommen Sie zum iiRDS-Café auf der tekom-Messe und lassen Sie sich Ihre Fragen von Experten beantworten. mehr ...

Der Technische Redakteur als Wissensmanager. Vortrag von Ulrike Parson

Die tekom Österreich veranstaltet am 30. November 2018 in Wels eine Tagung zum Thema "Von der Dokumentation zum Wissensmanagement". Ulrike Parson ist eine der vier Referenten. mehr ...

Version 1.0 von iiRDS veröffentlicht

Die tekom veröffentlichte am 18. April 2018 Version 1.0 von iiRDS, dem herstellerübergreifenden Standard für die Auslieferung und Abfrage intelligenter Informationen. parson beteiligte sich aktiv an der Entwicklung von iiRDS (intelligent information Request and Delivery Standard). mehr ...
  • linkedin
  • xing