Creating Documentation With A Wiki: The DITA Storm Project
Presented at DocTrain East 2007 by Alex Karesin -- Wiki-based content authoring is gaining momentum. This simple concept provides exceptional convenience and ease of use for the editors. Ironically, benefits of free-style editing prevent it from penetrating into enterprise environments with stricter content structure and reusability requirements offered by, for example, DITA XML standard. How do you combine convenience of free style writing and advantages of structured, reusable DITA content? The concept of DITA wiki is designed to satisfy both. Alex Karezin shares his experience of creating and adopting DITA content management system that was built by integrating web-based DITA XML editor into wiki and generic CMS. We will look at wiki platforms from structured authoring perspective; identify suitable candidates, highlight their advantages, review different levels of DITA-wiki integration and summarize efforts required to achieve it. Lastly we will address data migration, survey user experience and draw conclusions.
![Overview ,[object Object],[object Object],[object Object],[object Object],[object Object]](data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7)
Empfohlen
Empfohlen
Weitere ähnliche Inhalte
Was ist angesagt?
Was ist angesagt? (20)
Ähnlich wie Creating Documentation With A Wiki: The DITA Storm Project
Ähnlich wie Creating Documentation With A Wiki: The DITA Storm Project (20)
Mehr von Scott Abel
Mehr von Scott Abel (20)
Kürzlich hochgeladen
Kürzlich hochgeladen (20)
Creating Documentation With A Wiki: The DITA Storm Project
- 1. Creating Documentation With A Wiki: DITA Storm Project Innovative Technology Track
- 3. DITA Content <topic> <title>Some little topic</title> <body> <p>Here's a <b><i>cute</i></b>, <b>little</b> topic. </p> <ul> <li>Some item</li> <li>Another item</li> </ul> </body> </topic> <task> <title>Restart your system</title> <shortdesc>This is standard procedure after installing any new software.</shortdesc> <taskbody> <steps> <step> <cmd>If you are on a Windows system, go to the start menu.</cmd> </step> <step> <cmd>If you are on a Linux system, contact your system administrator for assistance. You may not need to restart.</cmd> </step> … </steps> </taskbody> </task> <reference> <title>element</title> <shortdesc>Describes a single element …. </shortdesc> <refbody> <refsyn> <codeblock><!ELEMENT …></codeblock> </refsyn> <properties> <property> <proptype>string</proptype> <propvalue>name</propvalue> <propdesc>Name of the element… </propdesc> </property> ... </properties> <example> ... </example> </refbody> </reference>
- 5. Wiki wiki + encyclopedia content = wikipedia wiki + dictionary content = wiktictionary wiki + quotations = wikiquote wiki + ??? = wikimania … “A defining characteristic of wiki technology is the ease with which pages can be created and updated”
- 7. Wiki Features Discussion Versioning Reviewing
- 9. … is it truly unstructured?
- 10. More Examples…
- 14. DITA Storm + wiki