<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	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/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>Jared Smith &#187; Asterisk</title>
	<atom:link href="http://www.jaredsmith.net/tags/asterisk/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.jaredsmith.net</link>
	<description>Thoughts of a Traveling Geek</description>
	<lastBuildDate>Fri, 20 Jan 2012 15:53:54 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.3.1</generator>
		<item>
		<title>Documentation (or the lack thereof)</title>
		<link>http://www.jaredsmith.net/2008/07/23/documentation-or-the-lack-thereof/</link>
		<comments>http://www.jaredsmith.net/2008/07/23/documentation-or-the-lack-thereof/#comments</comments>
		<pubDate>Wed, 23 Jul 2008 06:59:49 +0000</pubDate>
		<dc:creator>jsmith</dc:creator>
				<category><![CDATA[Asterisk]]></category>
		<category><![CDATA[Documentation]]></category>
		<category><![CDATA[Fedora]]></category>
		<category><![CDATA[Linux]]></category>
		<category><![CDATA[Fedora Documentation Project]]></category>
		<category><![CDATA[travel]]></category>

		<guid isPermaLink="false">http://www.jaredsmith.name/?p=9</guid>
		<description><![CDATA[I&#8217;m in Seoul, Korea this week teaching one of the ever-popular Asterisk Bootcamp classes.  As luck would have it, my hotel room has the most amazing remote control in the world!  Not only does it control the big ol&#8217; LCD TV and the DVD player, but it also controls the air conditioner and all the [...]]]></description>
			<content:encoded><![CDATA[<p><a href="http://www.jaredsmith.name/wp-content/uploads/2008/07/remote.jpg"><img class="alignleft size-full wp-image-11" title="Remote Control" src="http://www.jaredsmith.name/wp-content/uploads/2008/07/remote.jpg" alt="Check out the yellow labels -- what do the rest of the buttons do?" width="200" height="489" /></a>I&#8217;m in Seoul, Korea this week teaching one of the ever-popular <a title="Asterisk Training" href="http://www.digium.com/en/training/locator/" target="_blank">Asterisk Bootcamp</a> classes.  As luck would have it, my hotel room has the most amazing remote control in the world!  Not only does it control the big ol&#8217; LCD TV and the DVD player, but it also controls the air conditioner and all the lights in the room (including both lights in the bathroom!)</p>
<p>In trying to actually use the remote control, however, I was given a stark reminder of how important documentation can be.  As you probably already know, I try to take an active role in the documentation teams for both Asterisk and the Fedora Project, but never seem to make the time to write as much as I&#8217;d like.  As such, I can only hope our documentation efforts are more effective than the yellow labels on my remote control &#8212; just documenting the bare minimum and forcing the user to experiment to do anything useful (and very likely getting lost in the process).</p>
<p>(It&#8217;s my own personal opinion that this is one of the ways that free/open source software often fails to keep up with it&#8217;s commercial rivals; Many open source projects can&#8217;t afford to hire technical writers, and if they&#8217;re lucky enough to have volunteers do the work, there often isn&#8217;t much praise for the hard work and effort that goes into it.)</p>
<p>If this reminder has you feeling the same way I am, why not step up to the plate and help out on the documentation front?  After all, the <a title="Paul W. Frields" href="http://marilyn.frields.org:8080/~paul/wordpress/?p=1066" target="_blank">fearless leader</a> and the rest of the docs crew needs your help!  As the old adage goes&#8230; many hands makes light work!  We&#8217;d be glad to have you join our ranks.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.jaredsmith.net/2008/07/23/documentation-or-the-lack-thereof/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
	</channel>
</rss>

