tekom - Tagungen

Die Softwareentwickler sind los – einfache Dokumentationsumgebung für komplexe Anforderungen gesucht

  • Partnerpräsentation
  • Softwaredokumentation
  • 05. November
  • 10:00 - 10:45 AM (MEZ)
  • C7.2
  • beendet
  • Marion Knebel

    • parson AG
  •  Marion Knebel

    Marion Knebel

    • parson AG

Inhalt

Finnova entwickelt seit 50 Jahren smarte Banking-Lösungen. Rund 100 Softwareentwickler schreiben in agilen Scrum-Teams die Finnova Produktdokumentation. Die Inhalte aus Word und Confluence werden teilautomatisiert verarbeitet und übersetzt. Dieses dokumentenbasierte Setup lässt jedoch autoren- und nutzerseitige Probleme ansteigen. Unser Projekt in Zusammenarbeit mit der parson AG soll eine zeitgemäße Redaktionsumgebung mit leistungsfähigem Content Delivery schaffen. Passende Konzepte und Systeme zu finden ist herausfordernd, denn Schreibende ohne redaktionelle Ausbildung benötigen einfache Systeme, Nutzer wünschen sich intuitives Finden von Informationen an zentraler Stelle, das Dokumentations-Management braucht modulare, standardisierte Inhalte.

Nach umfassender Anforderungsanalyse konnte mithilfe von Sandbox-Tests die weitere Strategie für den anschließenden Proof-of-Concept festgelegt werden.

Wir berichten von unserem gemeinsamen Weg mit parson AG, der Vorgehensweise, den Schwierigkeiten unterwegs und von den wertvollen Learnings.

Das lernen Sie

Wie sieht ein Projekt zur Neugestaltung der Dokumentationsumgebung in einem untypischen Redaktionssetup aus? Welche Anforderungen sind relevant für Redaktionssystem und Content Delivery? Welche Risiken und Probleme treten auf?

Vorkenntnisse

keine

Referent:innen

Marion Knebel

  • parson AG
  • Zum Profil
Biografie

Marion Knebel arbeitete zunächst einige Jahre als Übersetzerin, hatte dann aber mehr Lust darauf, stattdessen die Quelltexte selbst zu verbessern. Sie wechselte auf die Autorenseite und wurde technische Redakteurin in einem Softwareunternehmen. Seit 2013 ist sie bei der parson AG und arbeitet immer noch gerne als Redakteurin, wobei sich der Fokus auf Entwicklerdokumentation sowie Spezifikationen technischer Standards verschoben hat, z.B. aus der Automobilbranche und dem Rohstoffhandel. Lange hat sie vor allem in Doc-as-Code-Umgebungen von Markdown bis XML gearbeitet, aber zunehmen geht es auch darum, Kunden bei der Einführeung neuer Redaktionssysteme zu bearaten oder ihre Informationsarchitekturen und Redaktionsprozesse zu optimieren. Dabei nutzt sie ihre Erfahrung in agilen Methoden, um die Projekte zielgerichtet voran zu bringen. Wenn es sich ergibt, freut sie sich immer, ihr Wissen in Form von Schulungen oder Vorträgen mit Gleichgesinnten oder solchen, die es werden wollen, zu teilen.

tbd

 Marion Knebel

Marion Knebel

  • parson AG
  • Zum Profil
Biografie

Marion Knebel arbeitete zunächst einige Jahre als Übersetzerin, hatte dann aber mehr Lust darauf, stattdessen die Quelltexte selbst zu verbessern. Sie wechselte auf die Autorenseite und wurde technische Redakteurin in einem Softwareunternehmen. Seit 2013 ist sie bei der parson AG und arbeitet immer noch gerne als Redakteurin, wobei sich der Fokus auf Entwicklerdokumentation sowie Spezifikationen technischer Standards verschoben hat, z.B. aus der Automobilbranche und dem Rohstoffhandel. Lange hat sie vor allem in Doc-as-Code-Umgebungen von Markdown bis XML gearbeitet, aber zunehmen geht es auch darum, Kunden bei der Einführeung neuer Redaktionssysteme zu bearaten oder ihre Informationsarchitekturen und Redaktionsprozesse zu optimieren. Dabei nutzt sie ihre Erfahrung in agilen Methoden, um die Projekte zielgerichtet voran zu bringen. Wenn es sich ergibt, freut sie sich immer, ihr Wissen in Form von Schulungen oder Vorträgen mit Gleichgesinnten oder solchen, die es werden wollen, zu teilen.

Marion Knebel arbeitete zunächst einige Jahre als Übersetzerin, hatte dann aber mehr Lust darauf, stattdessen die Quelltexte selbst zu verbessern. Sie wechselte auf die Autorenseite und wurde technische Redakteurin in einem Softwareunternehmen. Seit 2013 ist sie bei der parson AG und arbeitet immer noch gerne als Redakteurin, wobei sich der Fokus auf Entwicklerdokumentation sowie Spezifikationen technischer Standards verschoben hat, z.B. aus der Automobilbranche und dem Rohstoffhandel. Lange hat sie vor allem in Doc-as-Code-Umgebungen von Markdown bis XML gearbeitet, aber zunehmen geht es auch darum, Kunden bei der Einführeung neuer Redaktionssysteme zu bearaten oder ihre Informationsarchitekturen und Redaktionsprozesse zu optimieren. Dabei nutzt sie ihre Erfahrung in agilen Methoden, um die Projekte zielgerichtet voran zu bringen. Wenn es sich ergibt, freut sie sich immer, ihr Wissen in Form von Schulungen oder Vorträgen mit Gleichgesinnten oder solchen, die es werden wollen, zu teilen.