<?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; problem solving</title>
	<atom:link href="http://idratherbewriting.com/tag/problem-solving/feed/" rel="self" type="application/rss+xml" />
	<link>http://idratherbewriting.com</link>
	<description>The Latest Trends in Technical Communication</description>
	<lastBuildDate>Mon, 13 Feb 2012 22:26:51 +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>Problem Solving and Sprinkler Repair</title>
		<link>http://idratherbewriting.com/2010/07/15/problem-solving-and-sprinkler-repair/</link>
		<comments>http://idratherbewriting.com/2010/07/15/problem-solving-and-sprinkler-repair/#comments</comments>
		<pubDate>Fri, 16 Jul 2010 00:57:15 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[blog]]></category>
		<category><![CDATA[Creativity]]></category>
		<category><![CDATA[featured]]></category>
		<category><![CDATA[house]]></category>
		<category><![CDATA[problem solving]]></category>
		<category><![CDATA[troubleshooting]]></category>

		<guid isPermaLink="false">http://idratherbewriting.com/?p=6941</guid>
		<description><![CDATA[The other day Jane called and said I should come home because water was bubbling up in the sprinkler box in the yard. I don&#8217;t know anything about sprinkler systems, so with a sense of dread I drove home. Sure enough, the valve box was a puddle of water. I do know how to shut off the water to the sprinklers, so I did that ... <a href="http://idratherbewriting.com/2010/07/15/problem-solving-and-sprinkler-repair/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<p>The other day Jane called and said I should come home because water was bubbling up in the sprinkler box in the yard. I don&#8217;t know anything about sprinkler systems, so with a sense of dread I drove home. Sure enough, the valve box was a puddle of water. I do know how to shut off the water to the sprinklers, so I did that and then waited for the water to soak down into the ground or evaporate.</p>
<p>The next day, when the water was dry, I checked the sprinkler box again and found a crack in one of the valves. I turned the sprinklers back on and saw the water shoot out of the crack. Since much of sprinkler repair seems to be hunting for the broken pipe, and digging aimlessly for it, I felt lucky to see the actual break.</p>
<p>I googled the problem a bit and learned that the valve was called an irrigation valve. There were a few videos on installing irrigation valves, and it looked fairly easy to do &#8212; if all the pieces were new and exposed and easy to reach. The only problem was that I couldn&#8217;t turn any of the pipes and simply unscrew the old pipe to insert the new valve in place.</p>
<p>I needed some advice on how to fix the cracked valve. I have a mechanical engineer friend who knows all about sprinklers, and he said I would need to dig out the ground a bit and &#8220;clip&#8221; the old pipe in order to unscrew it from the valve.</p>
<p>This was the first time I&#8217;d dug into the ground to find the sprinklers. I tried my best to dig, but the ground where I live is nothing but rocky clay, so after 20 minutes of using my shovel like a pick axe and getting nowhere, I soaked the ground with water, waited 20 minutes, and then shoveled again. The ground moved like butter.</p>
<p>I unearthed the pipes and realized the pipes and valves were more complicated than they originally appeared.  Three pipes connected together in a tight space. Getting out the cracked valve would be more problematic than I thought. It all looked confusing, and I was wary of &#8220;clipping&#8221; a pipe.</p>
<p>At a lunch with my father-in-law, I asked him for advice on how to reconnect the pipe once I cut it, and he drew a diagram on a napkin and taught me some new terminology. The sprinkler box was a &#8220;manifold.&#8221; To connect the pipes I would need a &#8220;union&#8221; or &#8220;slip joint&#8221; or &#8220;connection coupling.&#8221;</p>
<p>I went to Home Depot and bought some spare parts according to what my father-in-law had said. The clerk gave me some more advice and told me what he thought I needed. Luckily sprinkler parts are cheap. I also bought a hacksaw and pair of channel locks.</p>
<p>Returning to the job, I cut the pipe that connected to the broken valve, and then attached the new valve. But to reconnect the pipe with a new coupling, I would need to bend back the pipe to make it fit. The pipe, however, <em>wouldn&#8217;t bend at all.</em> I consulted again with my sprinkler friend, and he said that the pipe wouldn&#8217;t move while it was impacted in the ground. I would need to dig a foot out on each side so that I could flex back the pipe and fit in the coupling.</p>
<p>After more digging, I had a big hole in my yard and another wheelbarrow full of dirt. I unearthed about two feet more of the pipe. Sure enough, the pipe now had more flex. I was still a little unclear about how to reconnect all the pipes, but I had to do something more than just stare at the problem, so I just applied the blue glue (which dries in ten seconds) and pulled the pipe back to fit over the coupling. I fit it together, but as I was screwing the pipe onto the new valve, I realized I had cut the pipe too short.</p>
<p>I stared at the problem again, scratching my head. Luckily the store clerk recommended that I buy an extra coupling. I asked my mechanical engineer friend for more advice (he happened to be walking down the street at the time), and he said I could cut the pipe again and add my second coupling next to the first to elongate the pipe. I did that, and sure enough it worked. Here&#8217;s a little video showing the solution.</p>
<p><object classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000" width="640" height="385" codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=6,0,40,0"><param name="allowFullScreen" value="true" /><param name="allowscriptaccess" value="always" /><param name="src" value="http://www.youtube.com/v/JwQsvYpno4M&amp;hl=en_US&amp;fs=1;hd=1" /><param name="allowfullscreen" value="true" /><embed type="application/x-shockwave-flash" width="640" height="385" src="http://www.youtube.com/v/JwQsvYpno4M&amp;hl=en_US&amp;fs=1;hd=1" allowscriptaccess="always" allowfullscreen="true"></embed></object></p>
<h3>A Simple Problem Solving Method</h3>
<p>This blog isn&#8217;t about sprinkler repair. But the experience made me reflect on problem solving. Regardless of our jobs, it seems that problem solving follows the same general steps.</p>
<p><strong></p>
<ol>
<li><span style="font-weight: normal;"><strong>Identify the real problem.</strong> In the case of the sprinklers, I located the crack in the valve that was causing the problem. But this wasn&#8217;t the real problem. The real problem was figuring out how to install the new valve given the inflexibility of the pipes. Many times problems are just like this. There is a surface-level problem, but when you dig down a bit, you see that the real problem is something else entirely. Identifying the real problem, or the root cause of the problem, is the first step in problem solving.</span></li>
<li><span style="font-weight: normal;"><strong>Research the solution.</strong> I searched online and consulted with knowledgeable people around me about the problem. I could have probably read more books and articles on sprinkler repair, but it&#8217;s hard to compete with neighborly advice from people who have similar sprinklers as me and are willing to give it.</span></li>
<li><span style="font-weight: normal;"><strong>Get your hands dirty.</strong> Sometimes to get to the area where you can fix the problem, you can&#8217;t be afraid to get dirty and go places you haven&#8217;t been before.  Digging up all that dirt was tedious and exhausting.  I didn&#8217;t even mention the electrical wire that I partially cut. Whatever the problem &#8212; fixing a website, changing the rotors on a car, repairing your broken water heater &#8212; you&#8217;re going to have to get your hands dirty with the guts of the product.</span></li>
<li><span style="font-weight: normal;"><strong>Start trying different solutions.</strong> You can think about the problem all you want, but until you start to act, you may not get anywhere. I stared at the pipes for a long time before deciding that I just had to cut and glue something. I knew that after I started to act, it would be clear to me what I needed to truly do. It&#8217;s similar to a writing maxim you may have heard: <em>How do I know what I think until I see what I say?</em> Once we start writing, it becomes clear in our minds what we&#8217;re thinking. Once we start acting, it becomes clear in our minds what we need to do.</span></li>
<li><span style="font-weight: normal;"><strong>Be patient.</strong> It took me three days, two trips to Home Depot, and about five separate consultations with friends to fix the problem. Having patience and being persistent even when the solution is distant can be your greatest asset in solving any problem.</span></li>
</ol>
<p></strong></p>
<h3>Problems Are Not Always This Simple</h3>
<p>Despite my &#8220;methodology&#8221; in the steps above, I candidly recognize that not all problems are this simple. If I could solve every problem in my life by following these five steps, life would be a cakewalk. But life is much tougher. For example, financial problems, behavioral problems, psychological problems &#8212; these are not so easily solved in a three-day, five-step process. However, I think that the points above do provide a starting point.</p>
<p>In my life, I let many of the problems that surround me go unchallenged. Either I&#8217;m lazy, or I don&#8217;t believe the solution is achievable, or I&#8217;ve become desensitized to the problem and have learned to live with it. I&#8217;ve given up tackling the problems as problems, if you know what I mean. It takes a little thing like a broken sprinkler to boost my confidence and spur me to tackle other, more significant problems.<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/2010/07/15/problem-solving-and-sprinkler-repair/feed/</wfw:commentRss>
		<slash:comments>7</slash:comments>
		</item>
		<item>
		<title>Thoughts on Troubleshooting and Problem Solving</title>
		<link>http://idratherbewriting.com/2009/01/19/thoughts-on-troubleshooting-and-problem-solving/</link>
		<comments>http://idratherbewriting.com/2009/01/19/thoughts-on-troubleshooting-and-problem-solving/#comments</comments>
		<pubDate>Tue, 20 Jan 2009 06:47:49 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[blog]]></category>
		<category><![CDATA[analysis]]></category>
		<category><![CDATA[consulting]]></category>
		<category><![CDATA[problem solving]]></category>
		<category><![CDATA[Technical Writing]]></category>
		<category><![CDATA[troubleshooting]]></category>
		<category><![CDATA[WordPress]]></category>

		<guid isPermaLink="false">http://www.idratherbewriting.com/?p=2697</guid>
		<description><![CDATA[Working in technology, I spend a good amount of my time troubleshooting. When things go wrong, I&#8217;ve learned a few tips and techniques: Compare line by line against a working model List all the components and how they work together Challenge every assumption Reboot or reinstall Google the error messages you see Site-search key sites Come back to it later Contact an expert Post the ... <a href="http://idratherbewriting.com/2009/01/19/thoughts-on-troubleshooting-and-problem-solving/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<div id="attachment_2700" class="wp-caption alignright" style="width: 160px"><a href="http://www.idratherbewriting.com/wp-content/uploads/2009/01/utahmtns.jpg"><img class="size-thumbnail wp-image-2700" title="Utah mountains" src="http://www.idratherbewriting.com/wp-content/uploads/2009/01/utahmtns-150x150.jpg" alt="Utah mountains" width="150" height="150" /></a><p class="wp-caption-text">Utah mountains</p></div>
<p>Working in technology, I spend a good amount of my time troubleshooting. When things go wrong, I&#8217;ve learned a few tips and techniques:</p>
<ul>
<li>Compare line by line against a working model</li>
<li>List all the components and how they work together</li>
<li>Challenge every assumption</li>
<li>Reboot or reinstall</li>
<li>Google the error messages you see</li>
<li>Site-search key sites</li>
<li>Come back to it later</li>
<li>Contact an expert</li>
<li>Post the question in a forum</li>
<li>Send the problem across Twitter</li>
</ul>
<p>As today was MLK day and I had work off, I had a chance to dive into some WordPress projects on my to-do list. In prioritizing projects, I realized what I find so addictive about WordPress: the troubleshooting. When a project is easy, I find it boring. The challenges are what draw me. So I start with the most difficult first. <span id="more-2697"></span></p>
<p>With WordPress problems, errors follow recurring patterns. If the alignment is completely wonky, it&#8217;s usually a div tag problem. If you receive sudden fatal errors that break the display, start deactivating plugins one by one.  Is your cursor acting funny? Clear your browser&#8217;s cache or upgrade to the latest version of WordPress. Is there a problem with links not connecting to posts or pages? Check out the .htaccess file. If it&#8217;s a CSS problem, e.g., can&#8217;t figure out the style, and viewing the source code doesn&#8217;t work, I sometimes perform CSS brain surgery, chopping large parts of CSS code displayed with the Firefox CSS Web Developer extension until I find the controlling style.</p>
<p>I also find it fulfilling to solve other people&#8217;s problems, even if they&#8217;re easy. For example, a client called explaining a need to include a LinkedIn-Share-This type button below the post. I did some digging (on a LinkedIn network) to <a href="http://wordpress.org/extend/plugins/sociable-zyblog-edition/">find the right plugin</a>, and then implemented the plugin on the phone with the client. That was pretty cool.</p>
<p>In fact, I changed my <a href="http://idratherbewriting.com/wordpress-consulting">WordPress training</a> model to specifically address problems people are having (rather than giving them a generic WordPress how-to). Most people reach out to me after they bang their heads in vain a few days.  They don&#8217;t want general information &#8212; they want to fix their problems.</p>
<p>In writing about troubleshooting, I don&#8217;t want to present myself as one without any technical problems. Like most people, I have a list of problems that I can&#8217;t quite seem to conquer. But that&#8217;s all right &#8212; it gives me a puzzle to solve, and the puzzles engage me.</p>
<p>Do you have any troubleshooting tips of techniques that work well for you? Or, for the WordPress users out there, what&#8217;s the most challenging problem you&#8217;ve faced, and how did you overcome it?<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/01/19/thoughts-on-troubleshooting-and-problem-solving/feed/</wfw:commentRss>
		<slash:comments>5</slash:comments>
		</item>
		<item>
		<title>Tapping your creative juices
Interestin &#8230;</title>
		<link>http://idratherbewriting.com/2008/08/08/tapping-your-creative-juicesinterestin/</link>
		<comments>http://idratherbewriting.com/2008/08/08/tapping-your-creative-juicesinterestin/#comments</comments>
		<pubDate>Fri, 08 Aug 2008 19:32:43 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[Notes]]></category>
		<category><![CDATA[problem solving]]></category>

		<guid isPermaLink="false">http://writerriver.com/2008/08/08/tapping-your-creative-juicesinterestin/</guid>
		<description><![CDATA[Tapping your creative juices Interesting division of challenges into component parts: &#8220;Sometimes the problem is cognitive, e.g. learning and explaining. Sometimes the problem is emotional, e.g. conflict resolution. Sometimes the problem is spiritual, e.g. conflict of interest. Sometimes the problem is physical, e.g. constrained by available resources. And most of the time the problem is a lovely blending of components that taxes body, soul, and ... <a href="http://idratherbewriting.com/2008/08/08/tapping-your-creative-juicesinterestin/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<p><a href="http://www.drexplain.com/isv-kaizen-blog/productivity/tapping-your-creative-juices/">Tapping your creative juices</a><br />
Interesting division of challenges into component parts: &#8220;Sometimes the problem is cognitive, e.g. learning and explaining. Sometimes the problem is emotional, e.g. conflict resolution. Sometimes the problem is spiritual, e.g. conflict of interest. Sometimes the problem is physical, e.g. constrained by available resources. And most of the time the problem is a lovely blending of components that taxes body, soul, and spirit.&#8221;</p>
]]></content:encoded>
			<wfw:commentRss>http://idratherbewriting.com/2008/08/08/tapping-your-creative-juicesinterestin/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Five Skills Every Technical Writer Needs</title>
		<link>http://idratherbewriting.com/2007/09/26/five-skills-every-technical-writer-needs/</link>
		<comments>http://idratherbewriting.com/2007/09/26/five-skills-every-technical-writer-needs/#comments</comments>
		<pubDate>Wed, 26 Sep 2007 04:51:01 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[blog]]></category>
		<category><![CDATA[graphics]]></category>
		<category><![CDATA[problem solving]]></category>
		<category><![CDATA[skills]]></category>
		<category><![CDATA[SMEs]]></category>
		<category><![CDATA[Technical Writing]]></category>
		<category><![CDATA[technology]]></category>

		<guid isPermaLink="false">http://www.idratherbewriting.com/2007/09/26/five-skills-every-technical-writer-needs/</guid>
		<description><![CDATA[A listener to the Tech Writer Voices podcast suggested I do a podcast on the following: Give ideas to people who are just starting out in technical writing. What is the base of knowledge that every technical writer should have? And so in preparation for the podcast, I offer these five skills or characteristics as absolute musts for the technical writer: 1. Facility with technology ... <a href="http://idratherbewriting.com/2007/09/26/five-skills-every-technical-writer-needs/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<p>A listener to the Tech Writer Voices podcast suggested I do a podcast on the following:</p>
<blockquote><p>Give ideas to people who are just starting out in technical writing.  What is the base of knowledge that every technical writer should have?</p></blockquote>
<p>And so in preparation for the podcast, I offer these five skills or characteristics as absolute musts for the technical writer:<span id="more-965"></span></p>
<h3>1. Facility with technology</h3>
<p>You have to be somewhat technical, although there are many different kinds of technicalese. You may have a bent towards one of the sciences, and can understand the inner workings of cells or atoms. Or you may be web savvy and know how to interpret code. Or maybe you&#8217;re just curious about how things work. You can learn technologies you don&#8217;t understand, if you have the motivation. I personally enjoy learning about complicated systems. This understanding brings a sense of achievement and knowledge that is rewarding at the end of the day.</p>
<h3>2. Ability to write clearly</h3>
<p>The essential skill of any technical communicator is to disambiguate (to use a word my father introduced to me the other day). Your core job will consist of taking complicated things and trying to explain them in easy-to-understand ways. You can&#8217;t just pass off an explanation you only half understand. Writing about something (as opposed to talking about it) requires you to understand it thoroughly. Avoid passive sentences and long constructions. Go from old ideas to new. Define acronyms and avoid assumptions about what the user knows. Make the reader feel smart.</p>
<h3>3. Talent in showing ideas graphically</h3>
<p>I underestimated the importance of using Visio until just a few months ago. Any time you can show an idea graphically, you score a hundred points with the reader. Almost everyone is a visual person. People understand better when you can communicate your ideas visually (and I&#8217;m not just talking about screenshots here, although they do count for something).  It is surprisingly easy to create half-decent diagrams in Visio. They go a long way toward making your writing clear.</p>
<h3>4. Patience in problem-solving/troubleshooting</h3>
<p>Unless you have patience, you&#8217;ll never make it. I think 80 percent of IT work consists of problem solving. What do you do when you can&#8217;t figure out how to do something? Do you slam your fist into your keyboard? Do you scream and curse when you can&#8217;t immediately figure something out? It&#8217;s amazing how you can see a seemingly impossible problem through with patience and persistence.</p>
<h3>5. Ability to interact with SMEs</h3>
<p>I talked about this in my last podcast on Tech Writer Voices. Interacting with SMEs is one the most overlooked skills in technical writing. You have to be part investigative reporter, part journalist. You can&#8217;t be shy about going after certain people to extract information. And you can&#8217;t be too proud to ask the &#8220;dumb technical questions&#8221; that make engineers do double-takes. A lot of this interaction can come about if you&#8217;re lucky enough to simply sit near SMEs.</p>
<p>I know I&#8217;m missing a few more essential qualities. I&#8217;d like to add a few more here. Any ideas?</p>
]]></content:encoded>
			<wfw:commentRss>http://idratherbewriting.com/2007/09/26/five-skills-every-technical-writer-needs/feed/</wfw:commentRss>
		<slash:comments>27</slash:comments>
		</item>
	</channel>
</rss>

