Slide 1Writing a book on a wiki – it works! by Sarah Maddox 1

Writing a book on a wikiWow, does that even work?

Atlassian User Group5 May 2012, Sydney

Slide 2Writing a book on a wiki – it works! 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

Slide 3Writing a book on a wiki – it works! by Sarah Maddox 3

Slide 4Writing a book on a wiki – it works! by Sarah Maddox

It’s a team effort, right from conception

4

Slide 5Writing a book on a wiki – it works! by Sarah Maddox

9 months’ labour – the content phase

15May

Submit proposal

3 Jun

31 Dec

Content deadline

Writing

15Feb

Production

3 Dec

5

Slide 6Writing a book on a wiki – it works! by Sarah Maddox

9 months’ labour – the content phase

6

15May

Submit proposal

3 Jun

31 Dec

15 Jun

15Feb

Content deadline

Writing

Admin and technical setup

Production

3 Dec

Slide 7Writing a book on a wiki – it works! by Sarah Maddox

9 months’ labour – the content phase

7

15May

Submit proposal

3 Jun

27 Nov

31 Dec

15 Jun

Content deadline

Writing

Admin and technical setup

15Feb

Production

3 Dec

Artwork and promotion

Slide 8Writing a book on a wiki – it works! by Sarah Maddox

9 months’ labour – the content phase

8

15May

Submit proposal

3 Jun

27 Nov

3 Dec

31 Dec

15 Jun

Content deadline

Writing

Admin and technical setup

Technical review

15Feb

Production

Artwork and promotion

Slide 9Writing a book on a wiki – it works! by Sarah Maddox

9 months’ labour – the content phase

9

15May

Submit proposal

3 Jun

27 Nov

3 Dec

31 Dec

15 Jun

22 Dec

Content deadline

Writing

Admin and technical setup

Artwork and promotion

Technical review

Index, footnotes, etc

15Feb

Production

Slide 10Writing a book on a wiki – it works! by Sarah Maddox

9 months’ labour – the production phase

10

15May

Submit proposal

3 Jun

27 Nov

3 Dec

15 Jun

22 Dec

7 Jan

5 Feb

Content deadline

Copy edit

Final proofs

Printing

31 Dec

15Feb

Production

Slide 11Writing a book on a wiki – it works! by Sarah Maddox

Permissions

Sharing a page via email

@mentions

Watching a page or a space

Notifications

RSS feeds

11

Managing reviewers’ and editors’ feedback

11

Slide 12Writing a book on a wiki – it works! by Sarah Maddox 12

Watching a space

Choose “Browse” > “Advanced”

> “Start watching this space”

Slide 13Writing a book on a wiki – it works! by Sarah Maddox 13

Setting your notification options

Choose the type of content you want to know about

Choose the format of the notifications

Slide 14Writing a book on a wiki – it works! by Sarah Maddox

Wiki plugins and add-ons

14

Slide 15Writing a book on a wiki – it works! by Sarah Maddox

Gliffy for diagrams

Image copyright © Sarah Maddox 2012

www.gliffy.com

15

Slide 16Writing a book on a wiki – it works! by Sarah Maddox

Cool, so now the book is on the wiki

16

Slide 17Writing a book on a wiki – it works! by Sarah Maddox

How to get from wiki to production

17

Slide 18Writing a book on a wiki – it works! by Sarah Maddox

Scroll Wiki DocBook Exporter

www.k15t.com

18

Slide 19Writing a book on a wiki – it works! by Sarah Maddox

It’s not over ‘til the wiki sings

http://wikitechcomm.onconfluence.com

19

Slide 20Writing a book on a wiki – it works! by Sarah Maddox

Prize draw

Winner!wikitechcomm.onconfluence.com

20

Slide 21Writing a book on a wiki – it works! by Sarah Maddox

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/

Drawings from the book are copyright © Ryan Maddox 2012http://ryanmaddoxart.wordpress.com/

21

Slide 22Writing a book on a wiki – it works! by Sarah Maddox 22

Contacting Sarah

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/

Slide 23Writing a book on a wiki – it works! by Sarah Maddox 23