Diff for DITA and Wikis

Fri, 2007-11-23 11:22 by Bruce EsrigMon, 2008-09-22 16:07 by ldyer

Announcement of the open-source DITA2Wiki project + more information about different approaches being discussed

Changes to Body
Line 3Line 3
 
</p>
 
</p>
 
<p>
 
<p>
-
'<a href="http://blogs.sun.com/coolstuff/entry/wikis_docs_and_the_reuse">Wikis, Docs, and the Reuse Proposition</a>' by Eric Armstrong of Sun explores the possibility of implementing DITA features using a combination of JavaScript and CSS. He suspects it can be done most easily using a Ruby-based Wiki like MediaCloth.
+
Three approaches are currently being discussed or implemented:
 
</p>
 
</p>
  +
<ul>
  +
<li>
  +
A DITA-enabled wiki</li>
  +
<li>Wiki as an output
  +
</li>
  +
<li>Wikislices (building DITA maps from wiki content)
  +
</li>
  +
</ul>
 
<p>
 
<p>
-
&#160;
+
Related to a DITA-enabled wiki, '<a href="http://blogs.sun.com/coolstuff/entry/wikis_docs_and_the_reuse">Wikis, Docs, and the Reuse Proposition</a>' by Eric Armstrong of Sun explores the possibility of implementing DITA features using a combination of JavaScript and CSS. He suspects it can be done most easily using a Ruby-based Wiki like MediaCloth.
  +
</p>
  +
<p>
  +
Related to DITA as an output, Lombardi has developed a system in which a mix of &quot;warrantied&quot; content is continuously updated from the DITA source while retaining &quot;unwarrantied&quot; community contributions. This system is described on <a href="http://www.slideshare.net/lisa.dyer/lombardi-wikis-model" target="_blank">SlideShare</a>.
  +
</p>
  +
<p>
  +
The model is enabled by a DITA2Confluence import tool developed by Lombardi. Lombardi has donated this tool to the open-source<a href="http://sourceforge.net/projects/dita2wiki/" target="_blank"> DITA2Wiki project</a>. To learn more, visit the <a href="http://development.lombardi.com/?p=68" target="_blank">Lombardi Development Blog</a>.
  +
</p>
  +
<p>
  +
Related to exporting content to DITA, the Wikislices vision is described in the April issue of <a href="http://www.stc.org/intercom/PDFs/2008/200804_18-21.pdf" target="_blank">STC Intercom</a>.
  +
</p>
  +
<p>
  +
&nbsp;
 
</p>
 
</p>
 
 
Revision of Mon, 2008-09-22 16:07:

DITA and Wikis

Wiki systems make it easy to edit documents online, which makes wikis a compelling tool for document collaboration. Current wiki formats, however, don't allow for the kind of reuse that the DITA was designed to enable.

Three approaches are currently being discussed or implemented:

  • A DITA-enabled wiki
  • Wiki as an output
  • Wikislices (building DITA maps from wiki content)

Related to a DITA-enabled wiki, 'Wikis, Docs, and the Reuse Proposition' by Eric Armstrong of Sun explores the possibility of implementing DITA features using a combination of JavaScript and CSS. He suspects it can be done most easily using a Ruby-based Wiki like MediaCloth.

Related to DITA as an output, Lombardi has developed a system in which a mix of "warrantied" content is continuously updated from the DITA source while retaining "unwarrantied" community contributions. This system is described on SlideShare.

The model is enabled by a DITA2Confluence import tool developed by Lombardi. Lombardi has donated this tool to the open-source DITA2Wiki project. To learn more, visit the Lombardi Development Blog.

Related to exporting content to DITA, the Wikislices vision is described in the April issue of STC Intercom.

 

XML.org Focus Areas: BPEL | DITA | ebXML | IDtrust | OpenDocument | SAML | UBL | UDDI
OASIS sites: OASIS | Cover Pages | XML.org | AMQP | CGM Open | eGov | Emergency | IDtrust | LegalXML | Open CSA | OSLC | WS-I