Wissensartikel

Das Stichwort agil ist in der Softwareentwicklung mindestens so beliebt wie DITA in der Technischen Dokumentation. Kein Wunder: Agil und DITA konzentrieren sich auf Modularisierung und die Anforderungen der Nutzer. Dieser Artikel beleuchtet, wie agiles Dokumentieren in der Praxis funktioniert, welche Tools die Prozesse unterstützen und welche Vor- und Nachteile sich für ein Dokumentationsteam ergeben. Weiterlesen

Klassischerweise wird Technische Dokumentation als Handbuch erstellt – für bestimmte Zielgruppen und Produktvarianten. Redaktionssysteme unterstützen Redakteure, Textmodule mit Metadaten zu versehen, sodass sie korrekt zu Handbüchern zusammengestellt werden können. Mit Industrie 4.0 und der stärkeren Modularisierung von Informationen ist handbuchbasierte Dokumentation jedoch nicht zukunftssicher. Weiterlesen

Wissen spielt eine wichtige Rolle für den Erfolg eines Unternehmens. Es trägt dazu bei, Alleinstellungsmerkmale zu schaffen, und es ist eine zentrale strategische Ressource bei der Entwicklung und Vermarktung von Produkten und Dienstleistungen. Weiterlesen

Es gibt viele Gründe, warum ein Unternehmenswiki scheitert: falsche Wahl der Software, fehlende Unterstützung der Geschäftsleitung, zu wenig Zeit für die Pflege. Dieser Artikel wird sich nicht mit all diesen Gründen beschäftigen, sondern sich auf unstrukturierte Inhalte und die Wiederauffindbarkeit von Artikeln konzentrieren. Weiterlesen

Anna M. ist Software-Entwicklerin. Seit kurzem arbeitet sie bei einer Firma, die spezialisierte Erweiterungen für eine kaufmännische Standardsoftware verkauft. Für die Entwicklung dieser Erweiterungen soll Anna das API der kaufmännischen Software verwenden. Aber Anna hat ein Problem. Sie weiß nichts über das API – seine Struktur, die Schnittstellen, die angebotenen Funktionen. Weiterlesen