<?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/"
	xmlns:series="http://unfoldingneurons.com/"
	>

<channel>
	<title>I&#039;d Rather Be Writing &#187; idiot</title>
	<atom:link href="http://idratherbewriting.com/tag/idiot/feed/" rel="self" type="application/rss+xml" />
	<link>http://idratherbewriting.com</link>
	<description>The Latest Trends in Technical Communication</description>
	<lastBuildDate>Fri, 10 Feb 2012 23:59:59 +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>A Microcosm of Technical Writing in the Kitchen While Cooking a Banana Cream Pie</title>
		<link>http://idratherbewriting.com/2009/11/27/a-microcosm-of-technical-writing-in-the-kitchen-while-cooking-a-pie-for-thanksgiving/</link>
		<comments>http://idratherbewriting.com/2009/11/27/a-microcosm-of-technical-writing-in-the-kitchen-while-cooking-a-pie-for-thanksgiving/#comments</comments>
		<pubDate>Fri, 27 Nov 2009 08:20:41 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[blog]]></category>
		<category><![CDATA[complex]]></category>
		<category><![CDATA[cooking]]></category>
		<category><![CDATA[idiot]]></category>
		<category><![CDATA[power users]]></category>
		<category><![CDATA[simple]]></category>
		<category><![CDATA[Technical Writing]]></category>
		<category><![CDATA[thanksgiving]]></category>
		<category><![CDATA[versions]]></category>

		<guid isPermaLink="false">http://www.idratherbewriting.com/?p=5095</guid>
		<description><![CDATA[As part of my contribution to the Thanksgiving dinner, Jane tasked me to cook a banana cream pie. She had a simple recipe already printed out. All the ingredients were available in the kitchen. The kitchen even had a double oven. I thought this would be easy, except it wasn&#8217;t. Because I suck at cooking. I hate cooking. If I cook, I need a &#8220;man&#8217;s ... <a href="http://idratherbewriting.com/2009/11/27/a-microcosm-of-technical-writing-in-the-kitchen-while-cooking-a-pie-for-thanksgiving/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<p>As part of my contribution to the Thanksgiving dinner, Jane tasked me to cook a banana cream pie. She had <a href="http://allrecipes.com/Recipe/Banana-Cream-Pie-I/Detail.aspx" target="_blank">a simple recipe</a> already printed out.</p>
<div id="attachment_5139" class="wp-caption alignnone" style="width: 510px"><a href="http://allrecipes.com/Recipe/Banana-Cream-Pie-I/Detail.aspx"><img class="size-full wp-image-5139" title="The banana cream pie recipe" src="http://www.idratherbewriting.com/wp-content/uploads/2009/11/bananacreampie.png" alt="The banana cream pie recipe" width="500" height="292" /></a><p class="wp-caption-text">The banana cream pie recipe</p></div>
<p>All the ingredients were available in the kitchen. The kitchen even had a double oven. I thought this would be easy, except it wasn&#8217;t. Because I suck at cooking. I hate cooking. If I cook, I need a &#8220;man&#8217;s cookbook,&#8221; one that cuts through the jargon and explains cooking concepts in idiot-like detail.</p>
<p>For example, try to make sense of this step:</p>
<blockquote><p>Stir a small quantity of the hot mixture into the beaten egg yolks, and immediately add egg yolk mixture to the rest of the hot mixture.</p></blockquote>
<p>This does not make sense to me. Pour A into B, and B into A? No reason given for this. Just do it. Why not simply pour A into B or B into A, rather than doing a little of both at nearly the same time?</p>
<p>Jane explained that this back-and-forth pouring of the hot custard would bring the egg yolks up to a warmer temperature slowly without causing the eggs to curdle. Oh, I said. Now I see, but that connecting logic was simply assumed in the instructions.<br />
<span id="more-5095"></span><br />
Here&#8217;s another place I tripped up:</p>
<blockquote><p><span>In a saucepan, combine the sugar, flour, and salt. Add milk in gradually while stirring gently. Cook over medium heat, stirring constantly, until the mixture is bubbly. Keep stirring and cook for about 2 more minutes, and then remove from the burner. </span></p></blockquote>
<p><span>Uhm, if I put dry ingredients in a saucepan on medium heat, they start to burn. Also, am I to mix the dry ingredients before adding them to the saucepan? How long do I have to stir this mixture &#8212; 5 minutes, 10 minutes? Bubbly means &#8230; slightly boiling, aerated, or some other state? </span></p>
<p><span>I stirred and stirred, but apparently not violently enough to get out all the clumps. I swear the mixture never got bubbly, but about 10 minutes into this step the mixture became thick and creamy &#8212; something I wasn&#8217;t expecting because there&#8217;s nothing in the instructions that indicated a dramatic change of state. Again, was I just supposed to know that the state would change, and that the changed state would mean the mixture was done?<br />
</span></p>
<p><span>I guess I had questions throughout. Here&#8217;s another place where I ran into a problem:<br />
</span></p>
<blockquote><p><span>Slice bananas into the cooled baked pastry shell.  Top with pudding mixture. </span></p></blockquote>
<p><span>The recipe calls for 4 bananas. After I added 3, Jane said to stop because there wouldn&#8217;t be any more room in the pie. But perhaps the pie&#8217;s final shape was meant to be convex, rounded at the top like a small hill? And if I put the bananas at the bottom and the pudding on top, wouldn&#8217;t that be uneven? Wouldn&#8217;t it be better to mix the two somehow for a more even distribution?</span></p>
<p><span>Finally, the banana cream pie recipe made no mention about whipped cream. Am I supposed to whip cream and add it to the top of the pie, like I&#8217;m accustomed to seeing in coconut-cream pie? Or is the custard filling the cream component of the pie?<br />
</span></p>
<p><span>I repeated several times my desire for a man&#8217;s cookbook, one that would provide more details, more straightforward explanations, and more hand-holding.</span></p>
<p><span>Yet for Jane, she preferred the abbreviated, concise recipe style because she&#8217;s familiar with the terminology and methods. When a recipe says to prick a pie shell, she knows about how many pricks to make, how deep to make them, and how much space between all the pricks. When I see instructions to prick a pie shell, I&#8217;m thinking up all kinds of scenarios about what this could mean.<br />
</span></p>
<p><span>Is not documentation exactly like this? You have the novices and the power users, and the instructions will inevitably frustrate one and appease the other.</span></p>
<p><span>Perhaps this is why I like online formats so much, because they allow you to add the extra detail in links pointing to additional pages, in drop-down hotspots, or through little information pop-ups. You&#8217;re not restricted by space. </span></p>
<p><span>My pie turned out well in the end. I&#8217;m guessing there was some wiggle room and leniency in the instructions, which is perhaps why some seemed vague. Overall, the Thanksgiving cooking experience was a perfect microcosm for the world of technical writing.<br />
</span><br />
<h2>Blog Sponsors</h2>
<ul>
<li><a href="http://webworks.com">Webworks ePublisher</a></li>
<li><a href="http://scriptorium.com">Scriptorium</a></li>
<li><a href="http://www.helpgenerator.com">Help Generator help authoring software</a></li>
<li><a href="http://idc.spsu.edu">Southern Polytechnic: Information Design and Communication</a></li>
<li><a href="http://simplifiedenglish.net">Simplified English</a></li>
<li><a href="http://info.mindtouch.com/irbw/tcs-custom-tour?persona=content">MindTouch</a></li>
<li><a href="http://www.madcapsoftware.com/products/madpak/overview.aspx?utm_source=IdRatherBeWriting&#038;utm_medium=Banner&#038;utm_campaign=MadPak"</a>Madcap Software</a></li>
<li><a href="http://www.drexplain.com/">Dr.Explain</a> </li>
<li><a href="http://www.adobe.com/products/technicalcommunicationsuite/try.html?sdid=ITRSO">Adobe Technical Communication Suite</a></li>
<li><a href="http://www.congree.com/en/download-congree-personal-edition.aspx">Congree</a></li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://idratherbewriting.com/2009/11/27/a-microcosm-of-technical-writing-in-the-kitchen-while-cooking-a-pie-for-thanksgiving/feed/</wfw:commentRss>
		<slash:comments>17</slash:comments>
		</item>
	</channel>
</rss>

