<?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: Wikis as documentation substitutes</title>
	<atom:link href="http://www.dissociatedpress.net/2006/09/02/wikis-as-documentation-substitutes/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.dissociatedpress.net/2006/09/02/wikis-as-documentation-substitutes/</link>
	<description>Linux, Open Source, and Tech Journalism</description>
	<lastBuildDate>Fri, 12 Mar 2010 04:56:06 +0000</lastBuildDate>
	
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
		<item>
		<title>By: Joe</title>
		<link>http://www.dissociatedpress.net/2006/09/02/wikis-as-documentation-substitutes/comment-page-1/#comment-3630</link>
		<dc:creator>Joe</dc:creator>
		<pubDate>Sun, 03 Sep 2006 16:21:16 +0000</pubDate>
		<guid isPermaLink="false">http://www.dissociatedpress.net/2006/09/02/wikis-as-documentation-substitutes/#comment-3630</guid>
		<description>&quot;Get pay-for-support and you have a good business model.&quot;

Not necessarily. A lot of proprietary apps with support have poor docs, and so do some pay-for-support open source operations. 

Wikipedia is a good example of the &quot;quick burst of information,&quot; not a well-planned manual. Wikipedia is a collection of articles -- which is what a wiki works well for.

&quot;Instead of complaining, why not develop some better plugins to achieve the goal you seek with the people who love and utilize the program.&quot;

Plugins for what, exactly? The problem isn&#039;t the lack of a killer documentation application -- it&#039;s a lack of people who are good at documentation who are willing to spend their time writing documentation for open source apps, and there are a few reasons for this:

1. The folks who are good at documentation tend to be spending their time doing just that as their full-time gig -- and don&#039;t necessarily want to spend an additional 10+ hours a week doing the same thing for open source projects. 

2. There&#039;s little incentive for tech writers to contribute documentation compared to the incentive programmers have to contribute code. If I&#039;m a programmer, I will probably work on a project that I want to use. Where&#039;s the incentive for a tech writer to spend time working on documentation that they&#039;ll never read again once it&#039;s finished?</description>
		<content:encoded><![CDATA[<p>"Get pay-for-support and you have a good business model."</p>
<p>Not necessarily. A lot of proprietary apps with support have poor docs, and so do some pay-for-support open source operations. </p>
<p>Wikipedia is a good example of the "quick burst of information," not a well-planned manual. Wikipedia is a collection of articles -- which is what a wiki works well for.</p>
<p>"Instead of complaining, why not develop some better plugins to achieve the goal you seek with the people who love and utilize the program."</p>
<p>Plugins for what, exactly? The problem isn't the lack of a killer documentation application -- it's a lack of people who are good at documentation who are willing to spend their time writing documentation for open source apps, and there are a few reasons for this:</p>
<p>1. The folks who are good at documentation tend to be spending their time doing just that as their full-time gig -- and don't necessarily want to spend an additional 10+ hours a week doing the same thing for open source projects. </p>
<p>2. There's little incentive for tech writers to contribute documentation compared to the incentive programmers have to contribute code. If I'm a programmer, I will probably work on a project that I want to use. Where's the incentive for a tech writer to spend time working on documentation that they'll never read again once it's finished?</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Lonny Paul</title>
		<link>http://www.dissociatedpress.net/2006/09/02/wikis-as-documentation-substitutes/comment-page-1/#comment-3629</link>
		<dc:creator>Lonny Paul</dc:creator>
		<pubDate>Sun, 03 Sep 2006 05:15:13 +0000</pubDate>
		<guid isPermaLink="false">http://www.dissociatedpress.net/2006/09/02/wikis-as-documentation-substitutes/#comment-3629</guid>
		<description>I think that although you are completely right in there are many fully undocumented or horribly documented open source applications which are used by thousands and thousands of websites and it is frustrating.

But that&#039;s part of the reason for OpenSource being free, they don&#039;t give you everything you need, there is no positive business model there.  Get pay-for-support and you have a good business model.

As to the direct assault on the Wiki platform for utilization of documentation, quick-setup guides and the like - I think your comments are fairly baseless.  Why?  Because the documentation efforts of any project is based on the individuals using it.  Could you say that there is anything that is hard to use about Wikipedia?  Nah.  It&#039;s so easy it&#039;s gonna be on the $100 Notebook projects in participating nations.

It seemingly has been used to add millions of articles and references, images and posts to document much of the living world, and only continues to grow and evolve. 

Yes, the non-WYSIWIG interface can be daunting to casual users, including a long-time IT guy like myself, but the overall concept, ability to further extend the application does allow for anything to be &#039;added.&#039;

Instead of complaining, why not develop some better plugins to achieve the goal you seek with the people who love and utilize the program.  

WordPress, and it&#039;s Codex documentation - is somewhat too much information and the search results tend to get me lost too - but there is a situation where it&#039;s &quot;too much&quot; instead of &quot;not enough.&quot;  Your dedication to wordpress as a platform for your publishing may be a testament to it in itself.

I&#039;m a complainer myself, but I at least try to lend credible suggestions for solution.  Using Google&#039;s program to generate documentation isn&#039;t a great idea - why?  It can only be done by the empassioned users.  And there isn&#039;t any real groundbreaking application development involved.</description>
		<content:encoded><![CDATA[<p>I think that although you are completely right in there are many fully undocumented or horribly documented open source applications which are used by thousands and thousands of websites and it is frustrating.</p>
<p>But that's part of the reason for OpenSource being free, they don't give you everything you need, there is no positive business model there.  Get pay-for-support and you have a good business model.</p>
<p>As to the direct assault on the Wiki platform for utilization of documentation, quick-setup guides and the like - I think your comments are fairly baseless.  Why?  Because the documentation efforts of any project is based on the individuals using it.  Could you say that there is anything that is hard to use about Wikipedia?  Nah.  It's so easy it's gonna be on the $100 Notebook projects in participating nations.</p>
<p>It seemingly has been used to add millions of articles and references, images and posts to document much of the living world, and only continues to grow and evolve. </p>
<p>Yes, the non-WYSIWIG interface can be daunting to casual users, including a long-time IT guy like myself, but the overall concept, ability to further extend the application does allow for anything to be 'added.'</p>
<p>Instead of complaining, why not develop some better plugins to achieve the goal you seek with the people who love and utilize the program.  </p>
<p>WordPress, and it's Codex documentation - is somewhat too much information and the search results tend to get me lost too - but there is a situation where it's "too much" instead of "not enough."  Your dedication to wordpress as a platform for your publishing may be a testament to it in itself.</p>
<p>I'm a complainer myself, but I at least try to lend credible suggestions for solution.  Using Google's program to generate documentation isn't a great idea - why?  It can only be done by the empassioned users.  And there isn't any real groundbreaking application development involved.</p>
]]></content:encoded>
	</item>
</channel>
</rss>
