![Page 1: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/1.jpg)
Confluence as a Platform for Technical Documentation
Sarah Maddox (Atlassian)
Tobias Anstett (K15t Software)
Darryl Duke (Stepstone Technologies)
Simplify and brand your documentation
Complete the documentation life cycle
Confluence as a platform for technical communication
Confluence as a Platform for Technical Documentation, by Sarah Maddox 1
wikitechcomm.onconfluence.com
Atlassian webinar, 12 April 2012
![Page 2: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/2.jpg)
Overview of Sarah’s presentation
• Confluence as extensible platform
• Developing a book on a wiki
• A platform for technical communicators
• Add-ons for enhanced functionality
• Driving wiki development
Confluence as a Platform for Technical Documentation, by Sarah Maddox 2
![Page 3: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/3.jpg)
Wiki as extensible platform
Confluence as a Platform for Technical Documentation, by Sarah Maddox 3
![Page 4: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/4.jpg)
Wiki as extensible platform
Confluence as a Platform for Technical Documentation, by Sarah Maddox 4
Extensible
Versatile
Ecosystem
![Page 5: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/5.jpg)
Wiki as extensible platform
Confluence as a Platform for Technical Documentation, by Sarah Maddox 5
Extensible
Versatile
Ecosystem
Atlassian: Core Confluence
Community developers: Add-ons
Experts: Integrations and services
![Page 6: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/6.jpg)
Wiki as extensible platform
Confluence as a Platform for Technical Documentation, by Sarah Maddox 6
Extensible
Versatile
Ecosystem
Atlassian: Core Confluence
Community developers: Add-ons
Experts: Integrations and services
Customers
![Page 7: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/7.jpg)
Confluence, Tech Comm, Chocolate
A wiki as platform extraordinaire for technical communication
Wikis and technical documentation
Agile environments
Social media
Crowd sourcing
Driving wiki development
And more
Confluence as a Platform for Technical Documentation, by Sarah Maddox 7
wikitechcomm.onconfluence.com
![Page 8: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/8.jpg)
Producing a book on a wiki
Confluence as a Platform for Technical Documentation, by Sarah Maddox 8
![Page 9: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/9.jpg)
Developing the book on the wiki
Dogfood
Collaboration
Diagrams
Location
Confluence as a Platform for Technical Documentation, by Sarah Maddox 9
![Page 10: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/10.jpg)
Dogfood
Collaboration
Diagrams
Location
Artist
Copy Editor
Reviewers
Author
Confluence as a Platform for Technical Documentation, by Sarah Maddox 9
Developing the book on the wiki
![Page 11: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/11.jpg)
Gliffy for diagrams
www.gliffy.com
Image copyright © Sarah Maddox 2012
Confluence as a Platform for Technical Documentation, by Sarah Maddox 10
![Page 12: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/12.jpg)
Cool, so now the book is on the wiki
Confluence as a Platform for Technical Documentation, by Sarah Maddox 11
![Page 13: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/13.jpg)
How to get from the wiki to production
?Confluence as a Platform for Technical Documentation, by Sarah Maddox 12
![Page 14: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/14.jpg)
Scroll Wiki DocBook Exporter
www.k15t.com
Confluence as a Platform for Technical Documentation, by Sarah Maddox 13
![Page 15: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/15.jpg)
Technical communicators
Keep up with new technology and methodology
Innovate
Share Ideas
CollaborateWork in diverseenvironments
Confluence as a Platform for Technical Documentation, by Sarah Maddox 14
![Page 16: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/16.jpg)
Technical communicators
Full of ideas
Experienced
PassionateSkilled
Confluence as a Platform for Technical Documentation, by Sarah Maddox 15
![Page 17: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/17.jpg)
Technical communicators
Need a tool thatcan keep up with us
Confluence as a Platform for Technical Documentation, by Sarah Maddox 16
![Page 18: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/18.jpg)
Workflow using core Confluence
Image copyright © Sarah Maddox 2012
Confluence as a Platform for Technical Documentation, by Sarah Maddox 17
![Page 19: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/19.jpg)
Add-ons for enhanced workflow
www.comalatech.com
www.frevvo.com
• Configurable workflows
• Shared workflows
• Content publishing
• Live forms
• Conditional routing
• Digital signatures
And more
Confluence as a Platform for Technical Documentation, by Sarah Maddox 18
![Page 20: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/20.jpg)
Look and feel with core Confluence
Confluence as a Platform for Technical Documentation, by Sarah Maddox 19
![Page 21: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/21.jpg)
Look and feel with core Confluence
Themes
CSS
Color Schemes
Logos
Velocity layouts
Site home page
Confluence as a Platform for Technical Documentation, by Sarah Maddox 20
![Page 22: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/22.jpg)
Look and feel with theme plugins
• Zen Foundation
• RefinedWiki
• Builder
• TechTime Blog
• BlackBerry
• iPhone and iPod Touch
• And more plugins.atlassian.com
Confluence as a Platform for Technical Documentation, by Sarah Maddox 21
![Page 23: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/23.jpg)
Zen Foundation theme
Confluence as a Platform for Technical Documentation, by Sarah Maddox 22
![Page 24: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/24.jpg)
Single source publishing
No wiki is an island
Confluence as a Platform for Technical Documentation, by Sarah Maddox 23
![Page 25: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/25.jpg)
Import Format ToolAnother Confluence wiki
The Confluence XML export and import tools are useful for downloading the content of a space, or an entire site, and uploading it into another Confluence site.
Other wikis The Universal Wiki Converter is a standalone tool that assists in converting pages to Confluence format from other wiki formats.
Microsoft Word Confluence's built-in Office Connector imports a Word document and converts it to one or more wiki pages based on the criteria you define. It processes one Word document at a time.
WebWorks ePublisher provides a set of standalone tools for converting Word documents to Confluence, based on custom styles and formats. Batch processing and scheduling are available.
Confluence as a Platform for Technical Documentation, by Sarah Maddox 24
Importing content into Confluence
![Page 26: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/26.jpg)
Import Format Tool
Adobe FrameMaker WebWorks ePublisher converts FrameMaker documents to Confluence
DITA XML DITA2wiki is a standalone tool that converts DITA XML documents to Confluence format and uploads them into the wiki via a set of Ant commands.
WebWorks ePublisher offers a set of standalone tools for conversion and import from DITA XML to Confluence wiki.
DocBook XML The DocBook import plugin is a Confluence plugin that converts DocBook XML to wiki format and imports the pages into a Confluence space.
Importing content into Confluence
Confluence as a Platform for Technical Documentation, by Sarah Maddox 25
![Page 27: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/27.jpg)
Export Format ToolAnother Confluence wiki
The Confluence XML export and import tools are useful for downloading the content of a space or an entire site and uploading it into another Confluence site.
Print The browser's print option will print a Confluence page. Export to PDF for sophisticated printing options.
PDF Confluence's built-in PDF export converts a selected page or pages into a single PDF file and provides customized layout and stylesheets.
Scroll Wiki PDF Exporter, a Confluence plugin, offers a PDF export with flexible themes for configuring layout and styles.
Microsoft Word Confluence's built-in Word export performs a basic conversion of wiki content to HTML and applies some predefined Word CSS stylesheets. It processes just one page at a time.
Scroll Office is a Confluence plugin that exports Confluence pages to Word based on custom templates. You can export a single page or a hierarchy of pages.
Exporting content from Confluence
Confluence as a Platform for Technical Documentation, by Sarah Maddox 26
![Page 28: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/28.jpg)
Exporting content from Confluence
Export Format ToolDocBook XML Scroll Wiki DocBook Exporter is a Confluence plugin that converts a
selected page or pages to DocBook XML.
HTML Confluence's built-in HTML export converts a single page, a selection of pages, or an entire space to HTML.
The Scroll Wiki HTML Exporter is a Confluence plugin that exports content from Confluence pages to styled HTML files.
Eclipse Help The Scroll Wiki EclipseHelp Exporter is a Confluence plugin that exports content from Confluence to Eclipse Help format.
JavaHelp The Scroll Wiki JavaHelp Exporter is a Confluence plugin that exports content from Confluence to JavaHelp format.
EPUB The Scroll Wiki EPUB Exporter is a Confluence plugin that exports Confluence pages to EPUB format.
Confluence as a Platform for Technical Documentation, by Sarah Maddox 27
![Page 29: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/29.jpg)
Many, many more add-ons
• Content reuse
• Metadata
• Templates
• Diagrams and mockups
• Social media integration
• Website and application integration
• You name itplugins.atlassian.com
Confluence as a Platform for Technical Documentation, by Sarah Maddox 228
![Page 30: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/30.jpg)
Confluence CLI by Bob Swift
https://plugins.atlassian.com/plugins/org.swift.confluence.cli
Confluence as a Platform for Technical Documentation, by Sarah Maddox 29
![Page 31: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/31.jpg)
Plugins in Atlassian OnDemandhttp://confluence.atlassian.com/display/AOD/Atlassian+OnDemand+Plugin+Policy
Team Calendars (commercial)
Gliffy (commercial)
Content Formatting Macros (free)
Table Plugin (free)
Confluence as a Platform for Technical Documentation, by Sarah Maddox 30
![Page 32: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/32.jpg)
How the book deals with Plugins
• Detailed in the content
• Listed at end of every chapter
• Introduced in chapters 2 and 4
• Extolled in chapter 23: Driving wiki
development
wikitechcomm.onconfluence.com
Confluence as a Platform for Technical Documentation, by Sarah Maddox 31
![Page 33: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/33.jpg)
Wiki as extensible platform
Confluence as a Platform for Technical Documentation, by Sarah Maddox 6
Extensible
Versatile
Ecosystem
Atlassian: Core Confluence
Community developers: Add-ons
Experts: Integrations and services
Customers
![Page 34: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/34.jpg)
Driving wiki development
Confluence as a Platform for Technical Documentation, by Sarah Maddox 33
Extensible
Versatile
Ecosystem
Atlassian: Core Confluence
Community developers: Add-ons
Experts: Integrations and services
![Page 35: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/35.jpg)
Driving wiki development
Raise requests: http://jira.atlassian.com
Join a user group: http://www.atlassian.com/company/community
Contact Atlassian: http://www.atlassian.com/company/contact
Contact a plugin developer: http://plugins.atlassian.com
Confluence as a Platform for Technical Documentation, by Sarah Maddox 34
![Page 36: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/36.jpg)
Developing add-ons yourself
Write a user macro: http://confluence.atlassian.com/display/DOC/Writing+User+Macros
Develop a plugin: https://developer.atlassian.com/display/DOCS/Developing+with+the+Atlassian+Plugin+SDK
Interact with the APIs: https://developer.atlassian.com/display/CONFDEV/Confluence+Developer+Documentation
Confluence as a Platform for Technical Documentation, by Sarah Maddox 35
![Page 37: Confluence as platform for technical documentation](https://reader036.vdocuments.mx/reader036/viewer/2022081420/554c6ac2b4c905f76f8b4cfb/html5/thumbnails/37.jpg)
Getting hold of the book
Wiki:https://wikitechcomm.onconfluence.com
Amazon.com:http://www.amazon.com/Confluence-Tech-Chocolate-Sarah-Maddox/dp/1937434001
Barnes & Noble:http://www.barnesandnoble.com/w/confluence-tech-comm-chocolate-sarah-maddox/1108812996?ean=9781937434007
XML Press:http://xmlpress.net/publications/chocolate/
Confluence as a Platform for Technical Documentation, by Sarah Maddox 36