Moving from monolithic to modular documentation
- Fachvortrag
- Content-Strategie & Informationsarchitektur
-
05. November
-
17:30
- 18:15
PM
(MEZ)
-
C6.2
-
Tanja Roth
- SUSE Software Solutions Germany GmbH
-
Julia Faltenbacher
- SUSE Software Solutions Germany GmbH
Inhalt
At SUSE, an open-source company, we maintain the software documentation and decided to move from writing huge guides towards a modular approach. We kept our established and self-maintained DocBook XML toolchain and XSLT stylesheets to publish PDF and HTML documentation variants. The switch to topic-basic authoring brings new challenges in content organizing and publishing. We are still in the transition phase and want to share our experience.
Das lernen Sie
This real life example shows the challenges of the project we are facing and gives insights into the solved and unresolved topics. Come, listen, and draw your own conclusions from our lessons learned.
Vorkenntnisse
Basic knowledge of software documentation and Single Source Publishing
Referent:innen
Tanja Roth
- SUSE Software Solutions Germany GmbH
Biografie
Driven by an interest in both language and technology, Tanja Roth has been working as a technical writer in various industries, such as mechanical engineering, medical technology, and IT for many years before becoming a project manager. She joined SUSE in 2005. She appreciates working with people from different backgrounds and from around the globe.
Julia Faltenbacher
- SUSE Software Solutions Germany GmbH
Biografie
Julia has more than 15 years of experience in localization, translation, terminology and technical writing. She joined SUSE in 2021 and is responsible for the GNOME User Guide and takes care of the localization of all SUSE guides. Her newest project, a company-wide terminology database, was just successfully launched.