<?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>Andrew-Becraft.com &#187; Technical Writing</title>
	<atom:link href="http://www.andrew-becraft.com/category/technical-writing/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.andrew-becraft.com</link>
	<description>Looking for one decent planet</description>
	<lastBuildDate>Thu, 19 Jan 2012 05:52:46 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.2.1</generator>
		<item>
		<title>How to make random strangers hate your pet</title>
		<link>http://www.andrew-becraft.com/2007/12/20/how-to-make-random-strangers-hate-your-pet/</link>
		<comments>http://www.andrew-becraft.com/2007/12/20/how-to-make-random-strangers-hate-your-pet/#comments</comments>
		<pubDate>Fri, 21 Dec 2007 05:59:54 +0000</pubDate>
		<dc:creator>Andrew</dc:creator>
				<category><![CDATA[Technical Writing]]></category>

		<guid isPermaLink="false">http://www.andrew-becraft.com/?p=9</guid>
		<description><![CDATA[One of the cool things I do (not astronaut or fireman cool, to be sure) is that I get to help design the user interface for my features. As a writer, this generally just involves writing all of the labels and error messages, but my wife is always joking that I don&#8217;t do enough to [...]]]></description>
			<content:encoded><![CDATA[<p>One of the cool things I do (not astronaut or fireman cool, to be sure) is that I get to help design the user interface for my features. As a writer, this generally just involves writing all of the labels and error messages, but my wife is always joking that I don&#8217;t do enough to use my powers for the fame and fortune of our dogs. Clearly, someone at Amazon.com has the same idea.</p>
<p>I had forgotten my iPod at home, so I was using my backup headphones to listen to <a href="http://www.pandora.com/" target="_new">Pandora</a>. (I&#8217;m so ineffective without the noise-canceling effects of music that I keep a pair of <i>backup headphones</i> in my desk drawer. With a little Johnny Cash or Death Cab for Cutie, I&#8217;m a tech writing machine.) I liked one of the artists and clicked their Amazon.com link to find out more, only to see this page:</p>
<p><a href="http://flickr.com/photos/dunechaser/2125696753/" target="_new"><img src="http://farm3.static.flickr.com/2031/2125696753_198604b542.jpg?v=0" width="500"></a></p>
<p>Now, there&#8217;s something to be said for friendly error messages &#8212; especially in consumer contexts like this one. The reader may even be disarmed enough not to be annoyed. To Amazon or Pandora&#8217;s credit, I&#8217;ve never seen the &#8220;Amazon.com Error Corgi&#8221; since, but I&#8217;ve encountered cutesy or mascot-themed error messages on other sites.</p>
<p>Flickr, for example, is famous for using the message &#8220;<a href="http://flickr.com/groups/flickr_massage/" target="_new">Flickr is having a massage</a>&#8221; during downtime. The first time I saw this, like the ideal user I mentioned earlier, I was highly amused. The second time I saw this (a month or two later), I was less amused but not annoyed. But when Flickr upgraded the site from Beta to &#8220;Gamma&#8221; (whatever that means), I saw this and other cutesy but useless error messages over, and over, and over. I was much less amused after several days of being locked out of my account.</p>
<p>The lesson here is that error messages should be easy to understand, but truly informative. (As a side note, I hate Apple error messages because there&#8217;s so very little real, actionable information in them. I could go on and on about the uselessness of Apple Help, but I&#8217;ll save that for another day.) Attempting to be colloquial or cute can in the long run backfire in situations where the users is likely to see the error repeatedly. </p>
<p>And that&#8217;s why Pugsly and Josie will never be featured in any of the error messages I write.</p>
<p><i>EDIT:</i> Here&#8217;s one of the Flickr error messages I was talking about, but didn&#8217;t have a screen shot at the time:</p>
<p><img src="http://farm3.static.flickr.com/2022/2160897012_f02bb0eaeb.jpg?v=0" width="500" /></p>
<p>Hiccups indeed.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.andrew-becraft.com/2007/12/20/how-to-make-random-strangers-hate-your-pet/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Meh.</title>
		<link>http://www.andrew-becraft.com/2006/12/22/meh/</link>
		<comments>http://www.andrew-becraft.com/2006/12/22/meh/#comments</comments>
		<pubDate>Sat, 23 Dec 2006 06:42:03 +0000</pubDate>
		<dc:creator>Andrew</dc:creator>
				<category><![CDATA[Creative Writing]]></category>
		<category><![CDATA[Literature]]></category>
		<category><![CDATA[Poetry]]></category>
		<category><![CDATA[Technical Writing]]></category>

		<guid isPermaLink="false">http://www.andrew-becraft.com/?p=3</guid>
		<description><![CDATA[I have a cold. Here&#8217;s what I&#8217;m reading right now: December issue of POETRY. Agile Project Management with Scrum by Ken Schwaber. Selected Poems by W.H. Auden Can Poetry Matter? by Dana Gioia]]></description>
			<content:encoded><![CDATA[<p>I have a cold. Here&#8217;s what I&#8217;m reading right now:</p>
<ul>
<li>December issue of <i>POETRY</i>.</li>
<li><i>Agile Project Management with Scrum</i> by Ken Schwaber.</li>
<li><i>Selected Poems</i> by W.H. Auden</li>
<li><i>Can Poetry Matter?</i> by Dana Gioia</li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://www.andrew-becraft.com/2006/12/22/meh/feed/</wfw:commentRss>
		<slash:comments>1</slash:comments>
		</item>
	</channel>
</rss>

