Dokumentieren im Wiki Atlassian User Group München München, 15. September 2011
Referent Dipl. Inf. Tobias Anstett Gründer und CTO von K15t Software Autor und Referent Wiki-basierte Dokumentation Sicherheitskonzepte im Cloud Computing Business Process Management
Firma Wir sehen in Wiki-basierten Konzepten und Technologien die Zukunft für Informationsportale und -plattformen. Wir entwickeln Werkzeuge für Wiki-basierte Dokumentation und strategisches Content Management. Als Produkt-getriebene Firma stellen wir mit unseren Scroll Plugins die Werkzeuge dazu bereit.
Your Wiki is not Wikipedia Einleitung
Wikipedia Wikipedia ist ein gutes Beispiel für kollaborativ erstellte Inhalte Dezember 2010 8579 Artikel wurden täglich eingestellt davon 433 aus Deutschland
Your Wiki is not Wikipedia Ein Enterprise-Wiki ist ein Wiki, welches typische Funktionalitäten bietet, die für Unternehmensanwendungen notwendig sind. Enteprise-Wikis sind ein wesentlicher Baustein im Gesamtkontext von Enterprise 2.0.
Enterprise Wikis Wissensmanagement Kollaboration Intranet Web Publishing Business Intelligence Extranet Dokumentation Shared Drives Blogging
Enterprise Wikis Wissensmanagement Kollaboration Intranet Web Publishing Business Intelligence Extranet Dokumentation Shared Drives Blogging
Web 2.0 - eine Kultur des Mitmachens Kollaborative Dokumentation
Wikis in der Dokumentation Schwerpunkt auf kollaborativen und sozialen Aspekten bzw. Funktionen bei der Erstellung und Bereitstellung von Inhalten Warum sich ein Wiki für Dokumentation Wikis als zentrale Ablage für alle Dokumente Wikis fördern die Mitarbeit an der Dokumentation Wikis machen Wissen besser verfügbar
Publikationsprozess Ein Publikationsprozess beinhaltet im allgemeinen die Phasen: Planung Erstellung Qualitätssicherung Publikation Feedback
Planung
Planung: Inhalte im Wiki Wikis werden oftmals als eine chaotische Sammlung von Informationen beschrieben Historisch bedingtes Vorurteil (Technologie) Fehlende Einführungsstrategie (von Einzelpersonen bzw. Einzelprojekten getrieben)
Planung: Struktur - Bereiche Spaces (Bereiche) gruppieren Inhalte sowohl logisch als auch physisch Abteilungen Projekte Produktgruppen / Produkte Dokumentation...
Planung: Struktur - Seiten Pages (Seiten) erlauben es hierarchische Strukturen zu schaffen Eine Seite kann 0-n Kindseiten haben Kindseiten können alphabetisch oder benutzerdefiniert sortiert werden
Planung: Struktur - Vorlagen Templates (Vorlagen) erlauben es dem Anwender Inhalte vorzudefinieren Templates können global und pro Space definiert werden 3rd Party Tools erweitern die Standardfunktionalität für Formulare Scaffolding (Customware) für Confluence 3.x Scroll Wiki Forms (K15t Software) für Confluence 4.0
Erstellung
Erstellung: Confluence 4.0 Editor
Erstellung: Formulare Frei: Der Autor kann frei über die Form der Inhalte entscheiden Semi-strukturiert: Eine Vorlage gibt einen Rahmen vor, welche Inhalte der Autor schreiben soll Formular-basiert: Das Formular gibt dem Autor die Felder bzw. Bereiche vor, die er ausfüllen muss
Confluence State of the Union Scroll Wiki Forms
Confluence State of the Union: Scroll Wiki Forms
Erstellung: Wiederverwendung Wiederverwendung findet auf der Ebene von Seiten statt Bausteine können sowohl intern (selber Bereich) oder aus einem anderen Bereich referenziert werden Macros erlauben des Weiteren die Einbindung externer Datenquellen
Qualitätssicherung
Qualitätsicherung: Workflows Wikis verfolgen den Ansatz einer ex-post Qualitätsicherung Autoren schreiben und aktualisieren Inhalte Inhalte werden aufgrund von Feedback anderer Nutzer kontinuierlich verbessert Workflows bilden redaktionelle Prozesse ab Status, Transitionen, Aktionen und Rechte Ad hoc Workflows (Comalatech) für Confluence 3.x /4.0
Publikation
Publikation: Versionierung Confluence versioniert seinen Inhalt per default Für jede Seite existiert eine Seitenhistorie Ganze Bereiche können über das Copy Space Plugin (Atlassian) kopiert und danach mittels Rechtemanagement eingefroren werden
Publikation: Cross Instance Publishing Durch sogenannte Space-Backups kann Inhalt von einem Confluence System auf ein anderes übertragen werden. 3rd Party Tools erweitern die Standardfunktionalität Content Publishing Plugin (Comalatech) Ermöglicht Draft Seiten in einen definierten Bereich zu publizieren Ist über Confluence Instanzen hinweg möglich
Publikation: Single Source Publishing (1/6) Confluence als Quelle aller Informationen für Exportiert nach PDF und Word 3rd Party Tools erweitern die Standardfunktionalität Scroll Wiki Exporter (K15t Software) Multiple Ausgabeformate PDF, Word, EclipseHelp, DocBook, EPUB Zielgruppenspezifische Aufbereitung Zielgruppenspezifisches Layout
Publikation: Single Source Publishing (3/6)
Launch Pad Scroll Wiki PDF Exporter
Launch Pad: Scroll Wiki PDF Exporter (1/6) Template Designer {
Launch Pad: Scroll Wiki PDF Exporter (2/6) Zielgruppensepzifisches Layout { Zielgruppensepzifische Aufbereitung
Launch Pad: Scroll Wiki PDF Exporter (3/6) Metainformationen {
Launch Pad: Scroll Wiki PDF Exporter (4/6) Linking Strategies {
Launch Pad: Scroll Wiki PDF Exporter (5/6) Export Progress Export Log
Launch Pad: Scroll Wiki PDF Exporter (6/6) Save Export Settings
Best Overall Plugin - Codegeist 2011 Scroll Wiki EPUB Exporter
Codegeist: Scroll Wiki EPUB Exporter Confluence Demonstration Space in ibooks
Feedback
Feedback: Dokumentation als Marketinginstrument Gute Dokumentation kann ein wichtiges Marketinginstrument sein Qualität der Dokumentation bzw. bereitgestellten Informationen als Indikator für Produktqualität Kunden zu involvieren bedeutet die Kunden kennenzulernen Wiki erlaubt Kommentar- und Bewertungsfunktionen Wiki kann gezielt für Suchmaschinen optimiert werden Möglichkeit zur Rückmeldung kann in viele digitale
Kontakt Informationen Weiter Informationen erhalten Sie... unter to http://www.k15t.com bei contact@k15t.com @k15tsoftware Oder treffen Sie uns persönlich... TC-World 19. Oktober
VIELEN DANK!