Is your company moving documentation to a wiki? What process and policy issues should you consider (preferably) before selecting a wiki for documentation? If the choice of a wiki has already been made for you, learn to manage expectations and produce the best outcome for your situation. Presentation by Janet Swisher at Technical Communication Summit, May 2011

1. This slide intentionally left blank

2. Policy and Process Considerations for Collaborative Authoring Environments Janet Swisher Mozilla Session hashtag: #boring

3. (Things to Think About)Before You Pick a Wiki Janet Swisher, @jmswisher Mozilla Session hashtag: #b4wiki

6. Knowledge capture

7. Project management

10. Photo by kennatakahashi

11. Photo by Nate Steiner

12. Photo by Jim Linwood

14. Content repository

15. Delivery platformAnn Rockley, Managing Enterprise Content, p. 312

17. How will you measure success?

18. What is the expected return on investment?

19. Where will the content come from?

20. Who will use the wiki initially?

21. Who will use the wiki in the future?

22. Who will own the wiki?

23. Where will the wiki be hosted?

24. Which wiki should I use?

26. 9%: do a little

27. 1%: do a lotJakob Nielsen, Participation Inequality: Encouraging More Users to Contribute

28. Who will do what? Roles Writers Editors SMEs Managers Partners Customers Tasks Writing Editing Reviewing Updating Maintaining

29. Define the editorial workflow Pre-publication review (may be necessary for external wikis) Post-publication review (via RSS feeds) Ad hoc review

30. Define the publication workflow Default: What happens in the wiki stays in the wiki Photo by Thierry

31. Define the publication workflow Wiki as an output format only: DITA2wiki

32. Define the publication workflow Print output from a wiki Confluence PDF export MediaWikiPdf Export extension (see wiki.service-now.com for an example)

33. Who stands behind it? IANAL: Consult your attorney for legal advice. Warrantied content (read-only) Unwarrantiedcontent (user-contributed)

34. What can we do with users’ content? IANAL: Consult your attorney for legal advice. Grant a license vs. assign copyright Explicitly stated in terms-of-use Should be irrevocable

35. What can users do with our content? IANAL: Consult your attorney for legal advice. Default: All Rights Reserved Creative Commons Other terms

36. Thanks! Resources I mentioned: http://www.janetswisher.com/?itemid=283 Email me: JMSwisher@gmail.com Follow me: @jmswisher Share your feedback: http://www.surveymonkey.com/stcsummit