Collaboration: A hands-on demo using Confluence wiki

Collaboration: A hands-on demo using Confluence wiki Scriptorium webcast 26/27 April 2012Collaboration using Confluence wiki, by Sarah Maddox Slide 1 1

Confluence, Tech Comm, Chocolate A wiki as platform extraordinaire for technical communication Introducing Sarah’s new book Wikis and technical documentation Agile environments Social media Crowd sourcing Driving wiki development And more wikitechcomm.onconfluence.comCollaboration using Confluence wiki, by Sarah Maddox Slide 2 2

A documentation wiki http://confluence.atlassian.com/display/DOC DemoCollaboration using Confluence wiki, by Sarah Maddox Slide 3 3

A developer documentation wiki https://developer.atlassian.com/ DemoCollaboration using Confluence wiki, by Sarah Maddox Slide 4 4

Introducing Donna Dark Technical communicator extraordinaire at Dangerous Liaisons I’m Donna and I’m everybody’s heroCollaboration using Confluence wiki, by Sarah Maddox Slide 5 5

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 featuresCollaboration using Confluence wiki, by Sarah Maddox Slide 6 6

Collaboration – a world of opportunity Developers Product managers SMEs Support engineers CustomersCollaboration using Confluence wiki, by Sarah Maddox Slide 7 7

Introducing the wiki With a wiki, you can edit a web page in A wiki your browser Confluence and other brands The dashboard Spaces PagesCollaboration using Confluence wiki, by Sarah Maddox Slide 10 10

Confluence dashboard Welcome message Recent activity DemoCollaboration using Confluence wiki, by Sarah Maddox Slide 11 11

Wiki spaces and pages Demo A hierarchical page structure in a space A page A list of spaces on my Confluence dashboardCollaboration using Confluence wiki, by Sarah Maddox Slide 12 12

Division of content into spaces  Per manual? One of Dangerous  Per product? Liaison’s products  Per product version? Killing Me Softly A space SOFT010 SOFT011 SOFT020Collaboration using Confluence wiki, by Sarah Maddox Slide 13 13

Building a documentation space Add the SOFT010 space Let’s get Theme cracking Permissions Design the home page Wiki editor Build a skeleton table of contents Add the key pages 14 Move and order pagesCollaboration using Confluence wiki, by Sarah Maddox Slide 14 14

Adding your space (1) Demo Adding a space to Confluence You can change the permissions at any timeCollaboration using Confluence wiki, by Sarah Maddox Slide 15 15

Adding your space (2) Demo Choose the Documentation theme You can also change the theme at any timeCollaboration using Confluence wiki, by Sarah Maddox Slide 16 16

Setting the permissions Type of access Demo Groups Individuals Anonymous usersCollaboration using Confluence wiki, by Sarah Maddox Slide 17 17

Designing a space’s home page The default home page Demo The default content is pretty ordinary, reallyCollaboration using Confluence wiki, by Sarah Maddox Slide 18 18

Our new home pageCollaboration using Confluence wiki, by Sarah Maddox Slide 19 19

Designing a space’s home page Demo Our new home pageCollaboration using Confluence wiki, by Sarah Maddox Slide 20 20

Adding a skeleton TOC Demo The table of contents forms as you add the pagesCollaboration using Confluence wiki, by Sarah Maddox Slide 21 21

Collaboration tools  Permissions  Sharing a page via email  @mentions  Notifications  RSS feeds Let’s look at the basic workflowCollaboration using Confluence wiki, by Sarah Maddox Slide 22 22

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 overloadCollaboration using Confluence wiki, by Sarah Maddox Slide 24 24

Watching a page Choose “Tools” > “Watch”Collaboration using Confluence wiki, by Sarah Maddox Slide 25 25

Watching a space Choose “Browse” > “Advanced” > “Start watching this space”Collaboration using Confluence wiki, by Sarah Maddox Slide 26 26

Setting your notification options Choose the type of content you want to know about Choose the format of the notificationsCollaboration using Confluence wiki, by Sarah Maddox Slide 27 27

Setting your notification options ?? Haven’t you seen enough of my profile?Collaboration using Confluence wiki, by Sarah Maddox Slide 28 28

Setting your notification options DemoCollaboration using Confluence wiki, by Sarah Maddox Slide 29 29

Building an RSS feed Choose “Browse” > “Feed Builder” Building an RSS feed in ConfluenceCollaboration using Confluence wiki, by Sarah Maddox Slide 30 30

Collaboration in action  Add a draft page: Release notes  Set permissions ready for review  Share page  Publish the pageCollaboration using Confluence wiki, by Sarah Maddox Slide 31 31

Draft page – release notes Demo Lock indicates page restrictionsCollaboration using Confluence wiki, by Sarah Maddox Slide 32 32

Ready for review Demo Broaden the page restrictions Share the pageCollaboration using Confluence wiki, by Sarah Maddox Slide 33 33

The dashboard activity stream DemoCollaboration using Confluence wiki, by Sarah Maddox Slide 34 34

Wiki plugins and add-onsCollaboration using Confluence wiki, by Sarah Maddox Slide 35 35

Add-ons for enhanced workflow  Configurable workflows  Shared workflows www.comalatech.com  Content publishing  Live forms www.frevvo.com  Conditional routing  Digital signatures And moreCollaboration using Confluence wiki, by Sarah Maddox Slide 36 36

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.comCollaboration using Confluence wiki, by Sarah Maddox Slide 37 37

The magic of collaborationCollaboration using Confluence wiki, by Sarah Maddox Slide 38 38

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/Collaboration using Confluence wiki, by Sarah Maddox Slide 39 39

QuestionsCollaboration using Confluence wiki, by Sarah Maddox Slide 40 40

Prize draw wikitechcomm.onconfluence.com Winner!Collaboration using Confluence wiki, by Sarah Maddox Slide 41 41

Contacting me Email: sarah@atlassian.com Twitter: @sarahmaddox http://twitter.com/sarahmaddox LinkedIn: http://au.linkedin.com/in/sarahmaddox Blog: http://ffeathers.wordpress.com Other blog: http://travellingworm.wordpress.com/Collaboration using Confluence wiki, by Sarah Maddox Slide 42 42

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.Collaboration using Confluence wiki, by Sarah Maddox Slide 43 43

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/confluenceCollaboration using Confluence wiki, by Sarah Maddox Slide 44 44

http://tecwrtrcollab.wikispaces.com	63
http://confluence.cmi-hro.nl	14

Collaboration: A hands-on demo using Confluence wiki

by Sarah Maddox

Accessibility

Categories

Upload Details

Usage Rights

2 Embeds 77

Statistics

Collaboration: A hands-on demo using Confluence wiki Presentation Transcript