<?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; knowledge</title>
	<atom:link href="http://idratherbewriting.com/tag/knowledge/feed/" rel="self" type="application/rss+xml" />
	<link>http://idratherbewriting.com</link>
	<description>The Latest Trends in Technical Communication</description>
	<lastBuildDate>Fri, 25 May 2012 16:20:03 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.3.2</generator>
		<item>
		<title>&#8220;I never really understood that feature, so I left it alone&#8230;&#8221;</title>
		<link>http://idratherbewriting.com/2010/02/12/i-never-really-understood-that-feature-so-i-left-it-alone/</link>
		<comments>http://idratherbewriting.com/2010/02/12/i-never-really-understood-that-feature-so-i-left-it-alone/#comments</comments>
		<pubDate>Fri, 12 Feb 2010 15:43:26 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[blog]]></category>
		<category><![CDATA[comfort]]></category>
		<category><![CDATA[comprehension]]></category>
		<category><![CDATA[knowledge]]></category>
		<category><![CDATA[Technical Writing]]></category>
		<category><![CDATA[understanding]]></category>
		<category><![CDATA[usability]]></category>

		<guid isPermaLink="false">http://www.idratherbewriting.com/?p=5710</guid>
		<description><![CDATA[The other day I rose early to conduct some user acceptance testing with a new version of our software. As I was going through the new version of the application with a user, he got excited about a new feature we were implementing, which allowed users to collaborate on items. Noting his excitement, and realizing that the new version of the software wouldn&#8217;t be released ... <a href="http://idratherbewriting.com/2010/02/12/i-never-really-understood-that-feature-so-i-left-it-alone/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<p>The other day I rose early to conduct some user acceptance testing with a new version of our software. As I was going through the new version of the application with a user, he got excited about a new feature we were implementing, which allowed users to collaborate on items. Noting his excitement, and realizing that the new version of the software wouldn&#8217;t be released for several more months, I explained that the current version had a similar feature as well that he could use.</p>
<p><em>Oh, that field?</em> he said. <em>I never really understood that feature, so I left it alone.</em><span id="more-5710"></span></p>
<p>The user wasn&#8217;t a novice. He used this application several hours a day, if not more. How could he be so comfortable leaving alone a feature that could be integral to his workflow, which could save him hours of time and make his life easier? I could hardly believe it.</p>
<h3>Knowledge Intake Thresholds</h3>
<p>As I related the feedback to my colleagues, they noted how we often do the same thing with applications we use. For example, I use iTunes to download podcasts, create playlists, and sync the audio to my iPod. I know iTunes can do a whole lot more, such as create smart playlists based on the music I most often play, but I&#8217;m not interested in that. I don&#8217;t quite know how to set it up, and frankly I&#8217;m happy with my current level of understanding.</p>
<p>Photoshop is another example. I can get by in Photoshop all right. Only when I absolutely have to learn something, such as layer masks, do I start pushing my knowledge deeper by going into the help.</p>
<p>I often give one-on-one WordPress training. This past Saturday I scheduled a two-hour call with someone implementing a wootheme. At about an hour and a half into the call, I could tell the person&#8217;s brain was saturated. I had hit the threshold on her knowledge intake for the day.</p>
<p>My own knowledge intake threshold maxes out at about an hour. This is why classes at schools aren&#8217;t longer than 50 minutes. After an hour, the amount of new knowledge you can continue to absorb goes downhill.</p>
<h3>Long-Term Learning</h3>
<p>As technical writers, it&#8217;s hard to feel empathy for users when they refuse to learn. <em>It&#8217;s all in the manual, if they would just read it, </em>we often say. But we have to remember that we spend months ramping up on a software application &#8212; users don&#8217;t. Our first experience of the application is usually in a development environment where features are only half-coded. As time passes and new features are developed, and we attend project meeting after meeting, we slowly add the new knowledge to what we&#8217;ve already learned. After six months of gradual ramping up, we&#8217;re experts on the application. We then try to teach users to be experts in a day, or more realistically, in about 20 minutes.</p>
<p>Do you see the problem? We get six months to learn little by little, being paid handsomely to do so. The user gets 20 minutes and must often take time out of his or her schedule to do it. It&#8217;s no wonder the user doesn&#8217;t naturally move into the expert knowledge range.</p>
<p>A more practical way to learn new software is to approach it bit by bit. An hour a day over the course of a month can be more helpful than a crash course. But how do you keep the user learning every day or week?</p>
<h3>Strategies to Keep the User Learning</h3>
<p>I&#8217;ve seen at least four methods to help users keep learning an application:</p>
<ul>
<li><strong>Daily tips.</strong> Some applications show a daily tip in an attempt to increase your knowledge little by little. However, these tips are often as successful as ad pop-ups on websites.</li>
<li><strong>Regular newsletters.</strong> Some companies provide a regular newsletter about their products. For example, <a href="http://techsmith.com" target="_blank">TechSmith</a> provides a periodic newsletter that usually has a couple of tips for using Camtasia Studio and Snagit. I scan this newsletter and will watch a video tutorial on a feature I&#8217;m unfamiliar with.</li>
<li><strong>Product blogs. </strong>Some products are robust enough that the company has an entire blog focused on the application. <a href="http://blogs.msdn.com/microsoft_office_word/" target="_blank">Microsoft Office</a> is one example.</li>
<li><strong>Interface tips. </strong>When there&#8217;s a new feature added to the application, the interface often highlights what&#8217;s new through a little bubble caption. This is common in Gmail.</li>
</ul>
<h3>Encouraging Desire</h3>
<p>Besides these methods, I&#8217;m not sure what you can do to help users continue to increase their knowledge of an application. The problem is that even if you provide the means for advanced learning, whether through tips, newsletters, blogs, or interface notes; users already familiar in performing a core set of tasks are inclined to remain in their comfort zone.</p>
<p>In their minds, they already know the application. Or they know it well enough to get by. As with most things in life, the problem in helping users learn isn&#8217;t so much strategy as awareness and desire. They often don&#8217;t know what they&#8217;re missing. So they don&#8217;t care about missing it.<br />
<h2>Blog Sponsors</h2>
<ul>
<li><a href="http://3rabbitz.com">3Rabbitz book</a></li>
<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/flare/overview.aspx?utm_source=IdRatherBeWriting&#038;utm_medium=Banner&#038;utm_campaign=Flare8"</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/02/12/i-never-really-understood-that-feature-so-i-left-it-alone/feed/</wfw:commentRss>
		<slash:comments>4</slash:comments>
		</item>
		<item>
		<title>Transitioning from Literary Studies to Technical Communication</title>
		<link>http://idratherbewriting.com/2008/11/20/transitioning-from-literary-studies-to-technical-communication/</link>
		<comments>http://idratherbewriting.com/2008/11/20/transitioning-from-literary-studies-to-technical-communication/#comments</comments>
		<pubDate>Thu, 20 Nov 2008 21:03:37 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[blog]]></category>
		<category><![CDATA[academia]]></category>
		<category><![CDATA[creative writing]]></category>
		<category><![CDATA[knowledge]]></category>
		<category><![CDATA[literature]]></category>
		<category><![CDATA[masters programs]]></category>
		<category><![CDATA[questions]]></category>
		<category><![CDATA[technical communication degrees]]></category>
		<category><![CDATA[Technical Writing]]></category>

		<guid isPermaLink="false">http://www.idratherbewriting.com/?p=2327</guid>
		<description><![CDATA[Last night, unable to sleep at about 4 a.m., either because I went to bed early or because I simply couldn&#8217;t sleep, I grabbed my BlackBerry, on its usual place on my nightstand, and began to read through my email and feeds, as I am accustomed to do, lying half-conscious on my pillow, when I saw this intriguing question from Harold Motley about whether the ... <a href="http://idratherbewriting.com/2008/11/20/transitioning-from-literary-studies-to-technical-communication/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<p><a href="http://www.idratherbewriting.com/wp-content/uploads/2008/11/literature.png"><img class="alignright size-thumbnail wp-image-2328" title="Transitioning from literary studies to technical writing -- Is it difficult?" src="http://www.idratherbewriting.com/wp-content/uploads/2008/11/literature-150x150.png" alt="" width="150" height="150" /></a></p>
<p>Last night, unable to sleep at about 4 a.m., either because I went to bed early or because I simply couldn&#8217;t sleep, I grabbed my BlackBerry, on its usual place on my nightstand, and began to read through my email and feeds, as I am accustomed to do, lying half-conscious on my pillow, when I saw this intriguing question from Harold Motley about whether the transition from literary studies to technical communication was fairly common, or rather difficult. <span id="more-2327"></span></p>
<p>Harold writes,</p>
<blockquote><p>I&#8217;ve just recently came across your website and I find your posts and podcasts very informative and interesting. I&#8217;m currently a third year undergraduate student studying English, philosophy and professional writing. In exploring possible post-undergraduate paths and careers, I have been extensively researching the careers of law and technical communication.</p>
<p>My strongest skill is writing; and most of the writing I do is through the form of papers, essays etc. in which I analyze text and form arguments. In addition to applying to law school I am also looking for other careers in which I can apply my strength and interest in writing.</p>
<p>I have looked at M.A. programs in Technical Communication and found a few in Chicago (where I live) and I was just wondering how beneficial this degree would be if I were to pursue a career in technical communication.</p>
<p>I do not have much technical knowledge aside from the standard programs like those in Microsoft Office. Would this hinder a successful transition into technical communication, or is the technical knowledge something I would acquire through grad school?</p>
<p>I&#8217;m planning on taking a technical writing class and another on writing &amp; the Web, which I think would act as a good intro into technical communication. Is the transition from literary studies to technical communication fairly common, or is it rather difficult? Also, what&#8217;s your opinion on a M.A. in Technical Communication and Information Design vs. a M.A. in Information Architecture?</p>
<p>I greatly appreciate any feedback you can give.</p>
<p>Harold</p></blockquote>
<p>To summarize, you&#8217;re debating between a career as a technical communicator or a lawyer, and you feel an inclination to pursue a masters program in technical communication because your strength is writing. If you pursue this route, you want to know whether you should get an advanced degree in some technical communication/information design/information architecture field.</p>
<p>First, let me say that I have no idea how to advise you. And according to <a href="http://www.joelonsoftware.com/items/2008/11/18.html">Joel Spolsky</a> and <a href="http://www.scripting.com/stories/2008/11/16/threeExamplesOfGreatBloggi.html">Dave Winer</a>, the blogosphere has too many examples of people expounding on things &#8212; often from anecdotal evidence &#8212; without having any expertise in the subject.</p>
<p>In that spirit, I direct you to the excellent post Scott Nesbitt wrote yesterday, which is <a href="http://www.dmncommunications.com/weblog/?p=682">amazingly and coincidentally relevant</a> to your question. Responding to the question of whether would-be technical writers should take courses, Scott writes,</p>
<blockquote><p>If you want to [take courses in technical writing], fine. I&#8217;ve never taken a formal technical writing course and I&#8217;ve done OK. That&#8217;s not quite true; in the late 90s, I did start to do a certificate program in information design and finished about half of the required courses.</p>
<p>Essentially, I&#8217;m a street-trained technical writer and technologist. I learned the basics of tech writing from a textbook that I bought at my alma mater&#8217;s <a href="http://www.ryerson.ca/bookstore/">bookstore</a> in the early 1990s. I put what I learned from that volume into practice by writing manuals for myself and for a community environmental group with which I volunteered. I critiqued those manuals, and others that I read. I wrote articles for technology publications. I taught myself HTML, graphics conversion, various computer skills, UNIX, and even tried to get a handle on SGML.</p>
<p>But a big part of my development as a technical communicator was the two years that I spent working at a financial software firm. Long hours, a mix of applications running on Windows and OpenVMS, and a lot of developers with a low tolerance for ignorance honed various skills.</p>
<p>That&#8217;s not to say a technical writing course won&#8217;t be useful. I just never saw the need for one. (<a href="http://www.dmncommunications.com/weblog/?p=682">&#8220;Becoming a Technical Communicator&#8221;</a>)</p></blockquote>
<p>Rather than putting all your effort into a technical writing course, Scott recommends you acquire technical knowledge related to whatever it is you&#8217;re documenting:</p>
<blockquote><p>Aside from basic computer skills, you should have (or plan to acquire) a good level of technical knowledge. At the <em>very least</em>, you should have a cursory knowledge of the key technologies you will or may be working with, of programming and scripting languages, and more.</p></blockquote>
<p>I echo what Scott says &#8212; if you need to know Java, or HTML, or some other technology, learn it. It may be more valuable to you than an academic degree.</p>
<p>Scott also brings up the importance of acquiring technical knowledge to gain respect from other team members. (Note: If respect is important to you, be sure to read this guest post: <a href="http://www.idratherbewriting.com/2008/11/04/guest-post-the-dark-side-of-technical-writing/">Technical Writing Careers – The Raw, Unvarnished Truth.</a>)</p>
<p>About applying to law school &#8212; when I was in college, I had a similar dilemma as you. I didn&#8217;t know whether I should pursue law or writing. My father supported me in either direction, but he thought fondly of the idea of my &#8220;sallying forth to battle the evils of the world through law,&#8221; or something to that effect.</p>
<p>I decided, for reasons I can&#8217;t remember, to go in the direction of writing instead. A few years later, while I was getting an MFA in creative writing, I became friends with a Columbia law student. Often at his house there would be dozens of law books lying around &#8212; half read, with bookmarks in various places. I realized, looking at his reading, that I never had an interest in law and could care less about this or that legal decision. I looked back to my deliberation between law and writing as foolishness.</p>
<p>So my advice to you on careers is this: What kinds of books do you have lying around your house? What are your real interests? Are you looking into law because you find law interesting, or because it&#8217;s one of those classic careers that everyone considers?</p>
<p>Now granted, it&#8217;s unlikely that you have a bunch of technical writing manuals lying around your house. (If so, you are weird.) Most likely you have literary texts here and there. You should know that technical writing is not the same as literary analysis, but it is still writing. As a technical writer, the kind of content people pay you to write is not creatively fulfilling. But that doesn&#8217;t mean it&#8217;s not challenging &#8212; it can bend your mind in exhausting ways.</p>
<p>A 250 page manual for a complicated product may be more difficult to write than a master&#8217;s thesis.  It may require a massive amount of deductive and inductive logic, as you try to figure out how the product works. You may spend months interviewing subject matter experts, asking them hundreds of questions about how the product functions, and then hundreds more to clarify their cryptic answers.</p>
<p>Once you accumulate a massive jumble of information, you&#8217;ll rack your brain trying to organize and arrange the content in a way that fits the vocabulary and behavior of your audience. You&#8217;ll shape and craft the manual, analyzing how each topic fits into the whole. You&#8217;ll shave words and phrases to increase the conciseness, rearrange one paragraph with another, deliberate over word choice and semantics, and consult various style manuals to ensure proper word choice, formatting, and punctuation.</p>
<p>As you near the end, you&#8217;ll go through the tedious editorial process, reviewing the printed manual with a red pen, circling, crossing out, writing notes, and then inputting your edits. Once you finish, you&#8217;ll feel a tremendous sense of accomplishment and breathe a heavy sigh of relief. Does this sound like a familiar process to you? It should.</p>
<p>Much like a scholarly essay on literature, almost no one will read it, except a select handful of people whom you will never meet. But you&#8217;ll still feel a lasting reward knowing that you conquered a monster and helped people come closer to the application truth, similar to how a literary scholar unfolds a book to show how the text really functions.</p>
<p>In brief, yes, your preparation in literary studies will prepare you well for the analytical and exhausting challenges of technical writing.</p>
<p>As to the question of which masters program I recommend, again, follow your interests. However, I see a lot more jobs for technical writers than I do for information architects or information designers. Given the state of the economy, you might not want to confine your specialty to a small niche that sounds cool, but in the end isn&#8217;t marketable.</p>
<p>Here are some other posts on the subject:</p>
<ul>
<li><a href="http://www.idratherbewriting.com/2008/02/16/technical-writing-careers-answering-13-questions-about-technical-writing-jobs/">Technical Writing Careers &#8212; Answering 13 Questions About Technical Writing Jobs</a></li>
<li><a href="http://www.idratherbewriting.com/2008/04/01/the-question-no-one-asked-me-at-the-career-advice-panel-thank-goodness/">The Question No One Asked Me at the Career Advice Panel, Thank Goodness</a></li>
<li><a href="http://www.idratherbewriting.com/2008/08/01/a-series-of-personal-essays-on-technical-writing-by-john-hewitt/">Personal Essays on a Technical Writing Career &#8212; By John Hewitt</a></li>
<li><a href="http://www.idratherbewriting.com/2008/06/26/myths-myths-myths-about-technical-writing/">14 Widespread Myths about Technical Writing</a></li>
<li><a href="http://www.idratherbewriting.com/2007/02/13/is-technical-writing-boring/">Is technical writing boring?</a></li>
<li><a href="http://www.idratherbewriting.com/2008/01/29/going-beyond-technical-writing-practical-advice-for-diversifying-your-skillset-podcast-interview-with-mark-hanigan/">Going Beyond Technical Writing: Practical Advice for Diversifying Your Skillset</a></li>
<li><a href="http://www.idratherbewriting.com/2008/04/09/a-few-questions-from-saudi-arabia-about-technical-writing/">Technical Writing: Worth it? Interesting? Creative? Well-paid? Answering a few questions from Saudi Arabia</a></li>
<li><a href="http://www.idratherbewriting.com/2008/09/28/ten-technical-writing-stereotypes/">Ten Technical Writing Stereotypes</a></li>
<li><a href="http://www.idratherbewriting.com/2007/05/27/how-to-break-into-technical-writing/">How to Break into Technical Writing</a></li>
<li><a href="http://www.idratherbewriting.com/2007/09/11/is-technical-writing-a-calling-or-a-job-recommended-dmn-communications-podcast/">Is Technical Writing a Calling or a Job &#8212; Recommended DMN Communications Podcast</a></li>
</ul>
<p>&#8212;&#8212;&#8212;-<br />
photo from <a href="http://www.flickr.com/photos/sassenach/121578983/">Flickr</a></p>
]]></content:encoded>
			<wfw:commentRss>http://idratherbewriting.com/2008/11/20/transitioning-from-literary-studies-to-technical-communication/feed/</wfw:commentRss>
		<slash:comments>16</slash:comments>
		</item>
	</channel>
</rss>

