collaboration: a hands-on demo using confluence wiki
DESCRIPTION
A Scriptorium webinar about technical communication, collaboration and Confluence wiki. This slide deck includes screenshots of the parts of the demo that were live on the wiki during the presentation.TRANSCRIPT
![Page 1: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/1.jpg)
Slide 1Collaboration using Confluence wiki, by Sarah Maddox 1
Collaboration: A hands-on demousing Confluence wiki
Scriptorium webcast26/27 April 2012
![Page 2: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/2.jpg)
Slide 2Collaboration using Confluence wiki, by Sarah Maddox 2
Confluence, Tech Comm, Chocolate
Wikis and technical documentation
Agile environments
Social media
Crowd sourcing
Driving wiki development
And more
A wiki as platform extraordinaire for technical communication
wikitechcomm.onconfluence.com
Introducing Sarah’s new book
![Page 3: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/3.jpg)
Slide 3Collaboration using Confluence wiki, by Sarah Maddox
A documentation wiki
3
Demohttp://confluence.atlassian.com/display/DOC
![Page 4: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/4.jpg)
Slide 4Collaboration using Confluence wiki, by Sarah Maddox
A developer documentation wiki
4
Demohttps://developer.atlassian.com/
![Page 5: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/5.jpg)
Slide 5Collaboration using Confluence wiki, by Sarah Maddox 5
Introducing Donna Dark
Technical communicator extraordinaire
at Dangerous Liaisons
I’m Donna and I’m everybody’s hero
![Page 6: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/6.jpg)
Slide 6Collaboration using Confluence wiki, by Sarah Maddox 6
What we will cover
Collaboration, and why it’s a Good Thing
Introduction to wikis and Confluence
Creating a technical communication space
Collaboration tools
Wiki plugins and add-ons
A “how to”, not a showcase of features
![Page 7: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/7.jpg)
Slide 7Collaboration using Confluence wiki, by Sarah Maddox
Collaboration – a world of opportunity
SMEs
Support engineers
Customers
Product managers
Developers
7
![Page 8: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/8.jpg)
Slide 8Collaboration using Confluence wiki, by Sarah Maddox
Life of a document up to publication
Image copyright © Sarah Maddox 2012
8
![Page 9: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/9.jpg)
Slide 9Collaboration using Confluence wiki, by Sarah Maddox
The real life of a document
9
Image copyright © Sarah Maddox 2012
![Page 10: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/10.jpg)
Slide 10Collaboration using Confluence wiki, by Sarah Maddox 10
Introducing the wiki
A wiki
Confluence and other brands
The dashboard
Spaces
Pages
With a wiki, you can edit a web page in your browser
![Page 11: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/11.jpg)
Slide 11Collaboration using Confluence wiki, by Sarah Maddox 11
Confluence dashboardDemoWelcome message Recent activity
![Page 12: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/12.jpg)
Slide 12Collaboration using Confluence wiki, by Sarah Maddox 12
A hierarchical page structure in a space
A list of spaces on my Confluence dashboard
A page
Demo
Wiki spaces and pages
![Page 13: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/13.jpg)
Slide 13Collaboration using Confluence wiki, by Sarah Maddox
Division of content into spaces
Per manual?
Per product?
Per product version?
Killing Me Softly
SOFT010 SOFT011 SOFT020
A space
One of Dangerous Liaison’s products
13
![Page 14: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/14.jpg)
Slide 14Collaboration using Confluence wiki, by Sarah Maddox
14
Building a documentation space
Let’s get cracking
Add the SOFT010 spaceThemePermissions
Design the home pageWiki editor
Build a skeleton table of contentsAdd the key pagesMove and order pages
14
![Page 15: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/15.jpg)
Slide 15Collaboration using Confluence wiki, by Sarah Maddox 15
Adding your space (1)
Adding a space to Confluence
Demo
You can change the permissions at any time
![Page 16: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/16.jpg)
Slide 16Collaboration using Confluence wiki, by Sarah Maddox 16
Demo
You can also change the theme at any time
Choose the Documentation theme
Adding your space (2)
![Page 17: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/17.jpg)
Slide 17Collaboration using Confluence wiki, by Sarah Maddox 17
Setting the permissionsDemo
Groups
Individuals
Anonymous users
Type of access
![Page 18: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/18.jpg)
Slide 18Collaboration using Confluence wiki, by Sarah Maddox 18
Designing a space’s home page
The default home page Demo
The default content is pretty ordinary, really
![Page 19: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/19.jpg)
Slide 19Collaboration using Confluence wiki, by Sarah Maddox 19
Our new home page
![Page 20: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/20.jpg)
Slide 20Collaboration using Confluence wiki, by Sarah Maddox 20
Our new home page
Demo
Designing a space’s home page
![Page 21: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/21.jpg)
Slide 21Collaboration using Confluence wiki, by Sarah Maddox 21
Adding a skeleton TOCDemo
The table of contents forms as you add the pages
![Page 22: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/22.jpg)
Slide 22Collaboration using Confluence wiki, by Sarah Maddox
Collaboration tools
Permissions
Sharing a page via email
@mentions
Notifications
RSS feeds
Let’s look at the basic workflow
22
![Page 23: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/23.jpg)
Slide 23Collaboration using Confluence wiki, by Sarah Maddox
Workflow using core Confluence
Image copyright © Sarah Maddox 2012
23
![Page 24: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/24.jpg)
Slide 24Collaboration using Confluence wiki, by Sarah Maddox 24
Monitoring updates
Watch a page or space
Set your notification options
Use RSS feeds
I need to stay on top of the news but avoid information overload
![Page 25: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/25.jpg)
Slide 25Collaboration using Confluence wiki, by Sarah Maddox 25
Watching a page
Choose “Tools” > “Watch”
![Page 26: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/26.jpg)
Slide 26Collaboration using Confluence wiki, by Sarah Maddox 26
Watching a space
Choose “Browse” > “Advanced”
> “Start watching this space”
![Page 27: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/27.jpg)
Slide 27Collaboration using Confluence wiki, by Sarah Maddox 27
Setting your notification options
Choose the type of content you want to know about
Choose the format of the notifications
![Page 28: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/28.jpg)
Slide 28Collaboration using Confluence wiki, by Sarah Maddox 28
Setting your notification options
?? Haven’t you seen enough of my profile?
![Page 29: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/29.jpg)
Slide 29Collaboration using Confluence wiki, by Sarah Maddox 29
Setting your notification optionsDemo
![Page 30: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/30.jpg)
Slide 30Collaboration using Confluence wiki, by Sarah Maddox 30
Building an RSS feed
Building an RSS feed in Confluence
Choose “Browse” > “Feed Builder”
![Page 31: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/31.jpg)
Slide 31Collaboration using Confluence wiki, by Sarah Maddox
Collaboration in action
Add a draft page: Release notes
Set permissions ready for review
Share page
Publish the page
31
![Page 32: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/32.jpg)
Slide 32Collaboration using Confluence wiki, by Sarah Maddox
Draft page – release notes
32
DemoLock indicates page restrictions
![Page 33: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/33.jpg)
Slide 33Collaboration using Confluence wiki, by Sarah Maddox
Ready for review
33
Demo
Share the pageBroaden the page restrictions
![Page 34: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/34.jpg)
Slide 34Collaboration using Confluence wiki, by Sarah Maddox
The dashboard activity stream
34
Demo
![Page 35: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/35.jpg)
Slide 35Collaboration using Confluence wiki, by Sarah Maddox
Wiki plugins and add-ons
35
![Page 36: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/36.jpg)
Slide 36Collaboration using Confluence wiki, by Sarah Maddox
Add-ons for enhanced workflow
www.frevvo.com
www.comalatech.com
Configurable workflows
Shared workflows
Content publishing
Live forms
Conditional routing
Digital signatures
And more
36
![Page 37: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/37.jpg)
Slide 37Collaboration using Confluence wiki, by Sarah Maddox
Many, many more add-ons Exporting and importing content to various formats
Look and feel (themes)
Content reuse
Metadata
Templates
Diagrams and mockups
Social media integration
Website and application integration
You name it plugins.atlassian.com37
![Page 38: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/38.jpg)
Slide 38Collaboration using Confluence wiki, by Sarah Maddox
The magic of collaboration
38
![Page 39: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/39.jpg)
Slide 39Collaboration using Confluence wiki, by Sarah Maddox
Getting hold of my 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/
Drawings from the book are copyright © Ryan Maddox 2012
http://ryanmaddoxart.wordpress.com/
39
![Page 40: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/40.jpg)
Slide 40Collaboration using Confluence wiki, by Sarah Maddox 40
Questions
![Page 41: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/41.jpg)
Slide 41Collaboration using Confluence wiki, by Sarah Maddox
Prize draw
Winner!wikitechcomm.onconfluence.com
41
![Page 42: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/42.jpg)
Slide 42Collaboration using Confluence wiki, by Sarah Maddox 42
Contacting me
Email: [email protected]
Twitter: @sarahmaddox
http://twitter.com/sarahmaddox
LinkedIn: http://au.linkedin.com/in/sarahmaddox
Blog: http://ffeathers.wordpress.com
Other blog: http://travellingworm.wordpress.com/
![Page 43: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/43.jpg)
Slide 43Collaboration using Confluence wiki, by Sarah Maddox 43
Taking your own wiki for a spin
Download Confluence or try it online:
http://www.atlassian.com/software/confluence/try
Licensing:
Evaluation for 30 days
Free for non-profit and open source organisations
$10 for a 10-user licence (proceeds go to “Room to Read”)
Commercial licences based on number of users
For this demo I used Confluence 4.2 installed locally on Windows 7. My browsers are Firefox and Chrome.
![Page 44: Collaboration: A hands-on demo using Confluence wiki](https://reader038.vdocument.in/reader038/viewer/2022103016/554f6cd0b4c905c8088b52d9/html5/thumbnails/44.jpg)
Slide 44Collaboration using Confluence wiki, by Sarah Maddox 44
References
Confluence wiki
Website: http://www.atlassian.com/software/confluence/
Software for technical documentation: http://www.atlassian.com/documentation-technical-writing-software/overview
Documentation: http://confluence.atlassian.com/display/DOC/
Plugins: https://plugins.atlassian.com/search/by/confluence