<?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: Making documentation more orderly</title>
	<atom:link href="http://www.bitstampede.com/2008/01/09/making-documentation-more-orderly/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.bitstampede.com/2008/01/09/making-documentation-more-orderly/</link>
	<description>Bits on the rampage: Eric Shepherd's blog.</description>
	<lastBuildDate>Wed, 01 Feb 2012 14:15:55 -0500</lastBuildDate>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.3.1</generator>
	<item>
		<title>By: sheppy</title>
		<link>http://www.bitstampede.com/2008/01/09/making-documentation-more-orderly/comment-page-1/#comment-68356</link>
		<dc:creator>sheppy</dc:creator>
		<pubDate>Thu, 14 Feb 2008 02:29:28 +0000</pubDate>
		<guid isPermaLink="false">http://www.bitstampede.com/2008/01/09/making-documentation-more-orderly/#comment-68356</guid>
		<description>Well, there are a couple people that keep an eye on things, but most of the documentation does not go through any kind of technical review process, which it really needs to.  We have people who are writing interface documentation but in only a few cases is anyone actually reviewing them to be sure they&#039;re actually accurate.

Just getting it written isn&#039;t enough -- people who know and use the technologies being documented need to read the docs and fix the errors, or at least let someone know about them so they can be fixed as quickly as possible.</description>
		<content:encoded><![CDATA[<p>Well, there are a couple people that keep an eye on things, but most of the documentation does not go through any kind of technical review process, which it really needs to.  We have people who are writing interface documentation but in only a few cases is anyone actually reviewing them to be sure they&#8217;re actually accurate.</p>
<p>Just getting it written isn&#8217;t enough &#8212; people who know and use the technologies being documented need to read the docs and fix the errors, or at least let someone know about them so they can be fixed as quickly as possible.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Sevenspade</title>
		<link>http://www.bitstampede.com/2008/01/09/making-documentation-more-orderly/comment-page-1/#comment-68336</link>
		<dc:creator>Sevenspade</dc:creator>
		<pubDate>Thu, 14 Feb 2008 00:40:21 +0000</pubDate>
		<guid isPermaLink="false">http://www.bitstampede.com/2008/01/09/making-documentation-more-orderly/#comment-68336</guid>
		<description>Sounds like what is already done.

I know I check the recent changes dating back to my last visit and specifically look for changes to the pages I&#039;m most concerned with, and it appears others do the same; you&#039;ve got &quot;interface people&quot; targeting the interfaces and Jason Orendorff in particular doing the same with the JSAPI docs.

In consideration of that, the closest thing to what you describe that would be a change from how things are done now would be to have some sort of formal &quot;owner&quot; to oversee changes made to their respective documentation topics, but I don&#039;t think activity at MDC is high&#8212;or chaotic&#8212;enough for that to be necessary.</description>
		<content:encoded><![CDATA[<p>Sounds like what is already done.</p>
<p>I know I check the recent changes dating back to my last visit and specifically look for changes to the pages I&#8217;m most concerned with, and it appears others do the same; you&#8217;ve got &#8220;interface people&#8221; targeting the interfaces and Jason Orendorff in particular doing the same with the JSAPI docs.</p>
<p>In consideration of that, the closest thing to what you describe that would be a change from how things are done now would be to have some sort of formal &#8220;owner&#8221; to oversee changes made to their respective documentation topics, but I don&#8217;t think activity at MDC is high&mdash;or chaotic&mdash;enough for that to be necessary.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Boris</title>
		<link>http://www.bitstampede.com/2008/01/09/making-documentation-more-orderly/comment-page-1/#comment-58661</link>
		<dc:creator>Boris</dc:creator>
		<pubDate>Wed, 09 Jan 2008 23:40:02 +0000</pubDate>
		<guid isPermaLink="false">http://www.bitstampede.com/2008/01/09/making-documentation-more-orderly/#comment-58661</guid>
		<description>If there are people with both the knowledge and the time to do this, I think it would be very good for the quality of the documentation!</description>
		<content:encoded><![CDATA[<p>If there are people with both the knowledge and the time to do this, I think it would be very good for the quality of the documentation!</p>
]]></content:encoded>
	</item>
</channel>
</rss>

