Successfully reported this slideshow.
What does DITA have to do with Wiki?  Information development models and implementation ideas Central Texas DITA Users Gro...
Introductions <ul><li>Ben Allums - Quadralay WebWorks </li></ul><ul><li>Chris Almond – IBM </li></ul><ul><li>Anne Gentle -...
Why use a wiki?  <ul><li>Originally created in 1995 for making quick web pages </li></ul><ul><li>Cross-platform, cross-bro...
Case study questions from WikiPatterns book <ul><li>Why did you choose a wiki?  </li></ul><ul><li>What type of wiki are yo...
Case study - WebWorks Wiki http://wiki.webworks.com/ <ul><li>Why did you choose a wiki?  </li></ul><ul><ul><li>Mailing lis...
Case study - WebWorks Wiki http://wiki.webworks.com/  <ul><li>What type of wiki are you using?  </li></ul><ul><ul><li>Moin...
 
Case study - WebWorks Wiki http://wiki.webworks.com/  <ul><li>How are you using the wiki? </li></ul><ul><ul><li>FAQ </li><...
Case study - WebWorks Wiki http://wiki.webworks.com/  <ul><li>What changes have you seen as a result of using the wiki? </...
Case study - WebWorks Wiki http://wiki.webworks.com/  <ul><li>Looking at WikiPatterns.com, which patterns or anti-patterns...
Case study - WebWorks Wiki http://wiki.webworks.com/  <ul><li>Have you done anything to encourage one pattern or squash ou...
Case study - WebWorks Wiki http://wiki.webworks.com/  <ul><li>Requirements for creating a “Wiki Company” </li></ul><ul><ul...
Case study - WebWorks Wiki http://wiki.webworks.com/  <ul><li>What does DITA have to do with Wiki? </li></ul><ul><ul><li>M...
Case study - WebWorks Wiki http://wiki.webworks.com/  <ul><li>What does DITA have to do with Wiki? </li></ul><ul><ul><li>G...
Case study - WebWorks Wiki http://wiki.webworks.com/  <ul><li>What does DITA have to do with Wiki? </li></ul><ul><ul><li>A...
Case study - IBM BlueWiki (internal)  <ul><li>Why did you choose a wiki?  </li></ul><ul><li>What type of wiki are you usin...
Case Study – One Laptop Per Child <ul><li>Why did you choose a wiki?  OLPC chose a wiki as an open source solution to offe...
Case Study – One Laptop Per Child <ul><li>Looking at WikiPatterns.com, which patterns or anti-patterns are in place?  The ...
What does DITA have to do with Wiki? <ul><li>Is wiki source or output? </li></ul><ul><li>Wikislices - using a DITA map to ...
 
Case study - Sun OpenDS Wiki https://www.opends.org/wiki  <ul><li>Why did you choose a wiki?  To create and distribute ope...
Case study - Sun OpenDS Wiki https://www.opends.org/wiki <ul><li>Looking at WikiPatterns.com, which patterns or anti-patte...
 
Upcoming SlideShare
Loading in …5
×

What Does DITA Have To Do With Wiki

5,221 views

Published on

Panel presentation at the January 2008 Central Texas DITA User Group meeting discussing wikis and structured authoring for technical documentation.

Published in: Technology

What Does DITA Have To Do With Wiki

  1. 1. What does DITA have to do with Wiki? Information development models and implementation ideas Central Texas DITA Users Group January 23, 2008
  2. 2. Introductions <ul><li>Ben Allums - Quadralay WebWorks </li></ul><ul><li>Chris Almond – IBM </li></ul><ul><li>Anne Gentle - OLPC </li></ul><ul><li>Ragan Haggard - Sun </li></ul>
  3. 3. Why use a wiki? <ul><li>Originally created in 1995 for making quick web pages </li></ul><ul><li>Cross-platform, cross-browser </li></ul><ul><li>Encourage collaboration - simultaneous edits </li></ul><ul><li>Encourage crowdsourcing and customer's view point </li></ul><ul><li>Living, breathing, changing documentation </li></ul><ul><li>Easy linking to other wiki pages </li></ul><ul><li>Subscription-based RSS feeds of recent changes, &quot;watch&quot; pages for edits </li></ul><ul><li>Easy searches within the body of the wiki </li></ul><ul><li>Scalability  - many pages edited by many authors </li></ul><ul><li>May save on customer support calls (eBay wiki) </li></ul><ul><li>Customer might expect a wiki when a customer forum isn't enough </li></ul><ul><li>Open source products often use wikis (Apache wiki) </li></ul><ul><li>Registration and log ins can control authoring privileges </li></ul>
  4. 4. Case study questions from WikiPatterns book <ul><li>Why did you choose a wiki? </li></ul><ul><li>What type of wiki are you using? </li></ul><ul><li>How are you using the wiki? </li></ul><ul><li>What changes have you seen as a result of using the wiki? </li></ul><ul><li>Looking at WikiPatterns.com, which patterns or anti-patterns are in place? </li></ul><ul><li>Have you done anything to encourage one pattern or squash out an anti-pattern? </li></ul>
  5. 5. Case study - WebWorks Wiki http://wiki.webworks.com/ <ul><li>Why did you choose a wiki? </li></ul><ul><ul><li>Mailing lists and forums discounted due to redundancy (existing “wwp-users”) and high moderation requirements </li></ul></ul><ul><ul><li>Already using them in Development </li></ul></ul><ul><ul><li>Enables public project workspaces, a “garage” for projects </li></ul></ul><ul><ul><li>Excellent place to “distill” reference materials </li></ul></ul>
  6. 6. Case study - WebWorks Wiki http://wiki.webworks.com/ <ul><li>What type of wiki are you using? </li></ul><ul><ul><li>MoinMoin </li></ul></ul><ul><ul><li>Active community </li></ul></ul><ul><ul><li>Theme support </li></ul></ul><ul><ul><li>Parser plug-ins (support for XML, ReStructured Text, alternate Wiki markup languages, source code) </li></ul></ul><ul><ul><li>Product integration options Wiki Publishing </li></ul></ul>
  7. 8. Case study - WebWorks Wiki http://wiki.webworks.com/ <ul><li>How are you using the wiki? </li></ul><ul><ul><li>FAQ </li></ul></ul><ul><ul><li>Tips and Tricks </li></ul></ul><ul><ul><li>Developer documentation </li></ul></ul><ul><ul><li>Projects – Enhancements </li></ul></ul><ul><ul><li>Staging area for documentation enhancements </li></ul></ul>
  8. 9. Case study - WebWorks Wiki http://wiki.webworks.com/ <ul><li>What changes have you seen as a result of using the wiki? </li></ul><ul><ul><li>Community self-help </li></ul></ul><ul><ul><li>Outlet for extended Support </li></ul></ul><ul><ul><li>Quick delivery of missing documentation </li></ul></ul><ul><ul><li>Customers honing their information requests </li></ul></ul>
  9. 10. Case study - WebWorks Wiki http://wiki.webworks.com/ <ul><li>Looking at WikiPatterns.com, which patterns or anti-patterns are in place? </li></ul><ul><ul><li>People Patterns: Invitation </li></ul></ul><ul><ul><li>Adoption Patterns: Built-in obsolescence, Community Write, Magnet, Scaffold </li></ul></ul><ul><ul><li>Adoption Anti-patterns: PageOwnership, Sandbox </li></ul></ul>
  10. 11. Case study - WebWorks Wiki http://wiki.webworks.com/ <ul><li>Have you done anything to encourage one pattern or squash out an anti-pattern? </li></ul><ul><ul><li>Patterns </li></ul></ul><ul><ul><ul><li>Actively request uses to place widely used “recipes” in the Wiki </li></ul></ul></ul><ul><ul><ul><li>AuthorGroup editable by AuthorGroup </li></ul></ul></ul><ul><ul><ul><li>Template pages and “New Page” forms </li></ul></ul></ul><ul><ul><ul><li>GUI edits despite potential side-effects </li></ul></ul></ul><ul><ul><li>Anti-Patterns </li></ul></ul><ul><ul><ul><li>Comment boxes – Any level of involvement is welcome </li></ul></ul></ul><ul><ul><ul><li>Ownership of home page (“FirstLast”) to reduce Wikiphobia </li></ul></ul></ul>
  11. 12. Case study - WebWorks Wiki http://wiki.webworks.com/ <ul><li>Requirements for creating a “Wiki Company” </li></ul><ul><ul><li>Identify your wiki’s goals </li></ul></ul><ul><ul><ul><li>Get everything out of people’s heads, white boards, Inboxes </li></ul></ul></ul><ul><ul><ul><li>Focus on effectiveness, not perfection </li></ul></ul></ul><ul><ul><li>Train all users </li></ul></ul><ul><ul><ul><li>Create a hands-on lab </li></ul></ul></ul><ul><ul><ul><li>Get people over the “Wikiphobia hump” </li></ul></ul></ul><ul><ul><li>Define workflows within the wiki as needed to promote the value of wiki use </li></ul></ul><ul><ul><ul><li>Services quotes </li></ul></ul></ul><ul><ul><ul><li>Product designs </li></ul></ul></ul><ul><ul><ul><li>Suggestions </li></ul></ul></ul>
  12. 13. Case study - WebWorks Wiki http://wiki.webworks.com/ <ul><li>What does DITA have to do with Wiki? </li></ul><ul><ul><li>Maybe nothing </li></ul></ul><ul><ul><li>How much training will you require of your domain specialists? </li></ul></ul><ul><ul><li>You have one hour to teach them </li></ul></ul><ul><ul><ul><li>Wiki markup </li></ul></ul></ul><ul><ul><ul><li>Base DITA topic structure </li></ul></ul></ul><ul><ul><ul><li>Your specialized DITA topic structure </li></ul></ul></ul>
  13. 14. Case study - WebWorks Wiki http://wiki.webworks.com/ <ul><li>What does DITA have to do with Wiki? </li></ul><ul><ul><li>Goals </li></ul></ul><ul><ul><ul><li>Projects </li></ul></ul></ul><ul><ul><ul><ul><li>Good, Fast, Cheap </li></ul></ul></ul></ul><ul><ul><ul><ul><li>Pick Two </li></ul></ul></ul></ul><ul><ul><ul><li>Content </li></ul></ul></ul><ul><ul><ul><ul><li>Knowledge, Reuse, Structure </li></ul></ul></ul></ul><ul><ul><ul><ul><li>Pick One? </li></ul></ul></ul></ul><ul><ul><li>Content goal for Wiki? </li></ul></ul><ul><ul><ul><li>Knowledge capture sounds pretty good </li></ul></ul></ul>
  14. 15. Case study - WebWorks Wiki http://wiki.webworks.com/ <ul><li>What does DITA have to do with Wiki? </li></ul><ul><ul><li>Avoid the “Tyranny of One” </li></ul></ul><ul><ul><ul><li>Content authored by domain specialists will rarely/never be used directly </li></ul></ul></ul><ul><ul><li>Explore the “Sluice Box” concept </li></ul></ul><ul><ul><ul><li>Raw Wiki </li></ul></ul></ul><ul><ul><ul><li>DITA topics Wiki </li></ul></ul></ul><ul><ul><ul><li>Specialized DITA Topics Wiki </li></ul></ul></ul><ul><ul><li>Leverage “ SisterSites ” – Review changes to information as necessary </li></ul></ul>
  15. 16. Case study - IBM BlueWiki (internal) <ul><li>Why did you choose a wiki? </li></ul><ul><li>What type of wiki are you using? </li></ul><ul><li>How are you using the wiki? </li></ul><ul><li>What changes have you seen as a result of using the wiki? </li></ul><ul><li>Looking at WikiPatterns.com, which patterns or anti-patterns are in place? </li></ul><ul><li>Have you done anything to encourage one pattern or squash out an anti-pattern? </li></ul>
  16. 17. Case Study – One Laptop Per Child <ul><li>Why did you choose a wiki? OLPC chose a wiki as an open source solution to offering information to developer volunteers initially, but end-users also need documentation in their wiki. </li></ul><ul><li>What type of wiki are you using? Mediawiki and Floss Manuals, which runs on TWiki, a structured wiki. </li></ul><ul><li>How are you using the wiki? wiki.laptop.org contains all information about the XO laptop, but Floss Manuals contains targeted information for certain audiences. The structured nature of the wiki would let us re-use content for different audiences such as kids, parents, school admins, or teachers. </li></ul><ul><li>What changes have you seen as a result of using the wiki? Since they started with it from the beginning, the only changes I’d say I observed was my own learning and building of mental models for the use of wikis for information storage. </li></ul>
  17. 18. Case Study – One Laptop Per Child <ul><li>Looking at WikiPatterns.com, which patterns or anti-patterns are in place? The Invitation pattern is a nicely done people pattern. They also have a nice Starting point on the OLPC wiki. And Welcoming is definitely a part of their best practices, even though it’s very difficult for them to keep up with the interest in volunteering. </li></ul><ul><li>Have you done anything to encourage one pattern or squash out an anti-pattern? I know there have been acts of Vandalism on people’s talk pages, but those just get reversed immediately by a very on-their-toes administrator. I guess the act was in retaliation for an answer someone gave in an FAQ. I also see a little bit of ThreadMess going on with some development-oriented pages. </li></ul>
  18. 19. What does DITA have to do with Wiki? <ul><li>Is wiki source or output? </li></ul><ul><li>Wikislices - using a DITA map to keep up with wiki “topic” (article) changes </li></ul><ul><li>DITA Storm – web-enabled DITA editor, but not very wiki-like </li></ul><ul><li>DITA to wikitext XSLT transform, but no round trip, have writers determine what content goes back to DITA source </li></ul>
  19. 21. Case study - Sun OpenDS Wiki https://www.opends.org/wiki <ul><li>Why did you choose a wiki? To create and distribute open-source technical documentation and so gain the contributions from the wider community. </li></ul><ul><li>What type of wiki are you using? JSPWiki </li></ul><ul><li>How are you using the wiki? www.opends.org/wiki provides user doc and developer documentation for an open source directory service. </li></ul><ul><li>What changes have you seen as a result of using the wiki? The wiki enables me to work 24 hours a day. </li></ul>
  20. 22. Case study - Sun OpenDS Wiki https://www.opends.org/wiki <ul><li>Looking at WikiPatterns.com, which patterns or anti-patterns are in place? Have you done anything to encourage one pattern or squash out an anti-pattern? Oddly enough, I promote the EmptyPages anti-pattern as a way for users to communicate their wish list to the community. We also persist in the Sandbox anti-pattern, because we think its useful. We're also planning to maintain the Registration Required anti-pattern because we need contributors to accept our terms of use and registration is the mechanism for that. Plus, I'm apprehensive about the amount of vandalism that would occur without registration. </li></ul>

×