<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
		>
<channel>
	<title>Comments on: Structured Wikis and Software Engineering &#8211; Documentation Throughout the Process</title>
	<atom:link href="http://justwriteclick.com/2008/11/04/structured-wikis-and-software-engineering-documentation-throughout-the-process/feed/" rel="self" type="application/rss+xml" />
	<link>http://justwriteclick.com/2008/11/04/structured-wikis-and-software-engineering-documentation-throughout-the-process/</link>
	<description>Documentation as conversation</description>
	<lastBuildDate>Sun, 14 Mar 2010 16:58:51 +0000</lastBuildDate>
	<generator>http://wordpress.org/?v=2.9</generator>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
		<item>
		<title>By: annegentle</title>
		<link>http://justwriteclick.com/2008/11/04/structured-wikis-and-software-engineering-documentation-throughout-the-process/comment-page-1/#comment-35072</link>
		<dc:creator>annegentle</dc:creator>
		<pubDate>Wed, 19 Aug 2009 02:21:00 +0000</pubDate>
		<guid isPermaLink="false">http://justwriteclick.com/?p=551#comment-35072</guid>
		<description>Hi Triona - Thanks for noticing that the link doesn&#039;t work any more! I&#039;ve changed the link so that you can download the link directly from my site instead of from the WikiSym site. Let me know if you have any trouble with the file, and I hope it&#039;s helpful to you.</description>
		<content:encoded><![CDATA[<p>Hi Triona &#8211; Thanks for noticing that the link doesn&#8217;t work any more! I&#8217;ve changed the link so that you can download the link directly from my site instead of from the WikiSym site. Let me know if you have any trouble with the file, and I hope it&#8217;s helpful to you.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: triona carey</title>
		<link>http://justwriteclick.com/2008/11/04/structured-wikis-and-software-engineering-documentation-throughout-the-process/comment-page-1/#comment-35036</link>
		<dc:creator>triona carey</dc:creator>
		<pubDate>Tue, 18 Aug 2009 19:14:45 +0000</pubDate>
		<guid isPermaLink="false">http://justwriteclick.com/?p=551#comment-35036</guid>
		<description>Hi there

Would be very interested in downloading this paper to share with information development co-workers but the link didn&#039;t work!

Is there an alternate download service?

All the best

Triona</description>
		<content:encoded><![CDATA[<p>Hi there</p>
<p>Would be very interested in downloading this paper to share with information development co-workers but the link didn&#8217;t work!</p>
<p>Is there an alternate download service?</p>
<p>All the best</p>
<p>Triona</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Lisa Dyer</title>
		<link>http://justwriteclick.com/2008/11/04/structured-wikis-and-software-engineering-documentation-throughout-the-process/comment-page-1/#comment-8432</link>
		<dc:creator>Lisa Dyer</dc:creator>
		<pubDate>Fri, 07 Nov 2008 17:39:30 +0000</pubDate>
		<guid isPermaLink="false">http://justwriteclick.com/?p=551#comment-8432</guid>
		<description>Hi Dave,

Are you thinking about localization from the perspective of hosting wiki content in multiple languages? Or edits to single-language wiki content by global community members? 

The former can be addressed with the model where information assets are maintained in DITA, and published to the wiki as part of a continuous publishing process (i.e. when updates are avail, publish again). In a multi-language content environment, you just publish once for each language set. Obviously, with this model, you are overwriting any page edits made by users since last refresh (comments remain untouched, which is important to note). But a good wiki lets you have control over who edits what and how those edits get processed further.

If you are sourcing your content on the wiki in multiple languages, the solution gets trickier. I have not seen a wiki system in which you can target a set of wiki pages in one language, and then generate new wiki pages in other languages (presumably with a TM integration). The more structured your content model is, the more predictable are your results. 

The latter represents a quality issue to me. When users make edits to &quot;warrantied&quot; content, you want to make sure the language, style, and technical accuracy are what you require them to be. To some extent, this is a general issue with any collaborative information development: you might have some set or users in a position of subject-matter expertise to &quot;code-review&quot; the edits. Another approach is to provide a space for &quot;unwarrantied&quot; content, which is consumed as-is and as such less constrained. If you&#039;re interested, there&#039;s more information about these models in my slideshare at http://www.slideshare.net/lisa.dyer/lombardi-wikis-model.

More than anything, it&#039;s important to define the right *process* for your wiki solution. For the most part, with some tooling, you can make any wiki work for you in the way you need it to in a global environment - although some wikis are better than others.

Hope this helps,

- lisa</description>
		<content:encoded><![CDATA[<p>Hi Dave,</p>
<p>Are you thinking about localization from the perspective of hosting wiki content in multiple languages? Or edits to single-language wiki content by global community members? </p>
<p>The former can be addressed with the model where information assets are maintained in DITA, and published to the wiki as part of a continuous publishing process (i.e. when updates are avail, publish again). In a multi-language content environment, you just publish once for each language set. Obviously, with this model, you are overwriting any page edits made by users since last refresh (comments remain untouched, which is important to note). But a good wiki lets you have control over who edits what and how those edits get processed further.</p>
<p>If you are sourcing your content on the wiki in multiple languages, the solution gets trickier. I have not seen a wiki system in which you can target a set of wiki pages in one language, and then generate new wiki pages in other languages (presumably with a TM integration). The more structured your content model is, the more predictable are your results. </p>
<p>The latter represents a quality issue to me. When users make edits to &#8220;warrantied&#8221; content, you want to make sure the language, style, and technical accuracy are what you require them to be. To some extent, this is a general issue with any collaborative information development: you might have some set or users in a position of subject-matter expertise to &#8220;code-review&#8221; the edits. Another approach is to provide a space for &#8220;unwarrantied&#8221; content, which is consumed as-is and as such less constrained. If you&#8217;re interested, there&#8217;s more information about these models in my slideshare at <a href="http://www.slideshare.net/lisa.dyer/lombardi-wikis-model" rel="nofollow">http://www.slideshare.net/lisa.dyer/lombardi-wikis-model</a>.</p>
<p>More than anything, it&#8217;s important to define the right *process* for your wiki solution. For the most part, with some tooling, you can make any wiki work for you in the way you need it to in a global environment &#8211; although some wikis are better than others.</p>
<p>Hope this helps,</p>
<p>- lisa</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Dave</title>
		<link>http://justwriteclick.com/2008/11/04/structured-wikis-and-software-engineering-documentation-throughout-the-process/comment-page-1/#comment-8394</link>
		<dc:creator>Dave</dc:creator>
		<pubDate>Fri, 07 Nov 2008 01:00:30 +0000</pubDate>
		<guid isPermaLink="false">http://justwriteclick.com/?p=551#comment-8394</guid>
		<description>Hi Anne,

Does your paper cover localization costs at all?
The largest barrier for me to moving towards a wiki is the localization cost associated with allowing anyone access to change anything. 

      - Dave</description>
		<content:encoded><![CDATA[<p>Hi Anne,</p>
<p>Does your paper cover localization costs at all?<br />
The largest barrier for me to moving towards a wiki is the localization cost associated with allowing anyone access to change anything. </p>
<p>      &#8211; Dave</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Sarah Maddox</title>
		<link>http://justwriteclick.com/2008/11/04/structured-wikis-and-software-engineering-documentation-throughout-the-process/comment-page-1/#comment-8329</link>
		<dc:creator>Sarah Maddox</dc:creator>
		<pubDate>Thu, 06 Nov 2008 00:40:26 +0000</pubDate>
		<guid isPermaLink="false">http://justwriteclick.com/?p=551#comment-8329</guid>
		<description>Hallo Anne and Lisa, Thanks for a great paper. It gives a very useful view into software development processes and the documentation produced by the development and QA teams in an agile environment. It shows the advantages of a wiki in such an environment, and how a bit (or a lot) of DITA-type structuring can help --- even if it&#039;s as simple as typing the content into the three basic types (concept, task and reference).

And then of course, there&#039;s the all-important area of user assistance. (That&#039;s us, folks :) ) The paper describes how the structured wiki-plus-DITA setup facilitates the transfer of knowledge across the development phases and amongst the teams.

Highly recommended reading :)</description>
		<content:encoded><![CDATA[<p>Hallo Anne and Lisa, Thanks for a great paper. It gives a very useful view into software development processes and the documentation produced by the development and QA teams in an agile environment. It shows the advantages of a wiki in such an environment, and how a bit (or a lot) of DITA-type structuring can help &#8212; even if it&#8217;s as simple as typing the content into the three basic types (concept, task and reference).</p>
<p>And then of course, there&#8217;s the all-important area of user assistance. (That&#8217;s us, folks <img src='http://justwriteclick.com/blog/wp-includes/images/smilies/icon_smile.gif' alt=':)' class='wp-smiley' />  ) The paper describes how the structured wiki-plus-DITA setup facilitates the transfer of knowledge across the development phases and amongst the teams.</p>
<p>Highly recommended reading <img src='http://justwriteclick.com/blog/wp-includes/images/smilies/icon_smile.gif' alt=':)' class='wp-smiley' /> </p>
]]></content:encoded>
	</item>
</channel>
</rss>
