<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" media="screen" href="/~d/styles/rss2full.xsl"?><?xml-stylesheet type="text/css" media="screen" href="http://feeds.feedburner.com/~d/styles/itemcontent.css"?><rss 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:feedburner="http://rssnamespace.org/feedburner/ext/1.0" version="2.0">

<channel>
	<title>Communications from DMN</title>
	
	<link>http://www.dmncommunications.com/weblog</link>
	<description />
	<lastBuildDate>Wed, 16 May 2012 17:00:10 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
			<atom10:link xmlns:atom10="http://www.w3.org/2005/Atom" rel="self" type="application/rss+xml" href="http://feeds.feedburner.com/dmncommunications/iceD" /><feedburner:info uri="dmncommunications/iced" /><atom10:link xmlns:atom10="http://www.w3.org/2005/Atom" rel="hub" href="http://pubsubhubbub.appspot.com/" /><feedburner:browserFriendly></feedburner:browserFriendly><item>
		<title>Tasting a little Confluence, Tech Comm, Chocolate</title>
		<link>http://www.dmncommunications.com/weblog/?p=2947</link>
		<comments>http://www.dmncommunications.com/weblog/?p=2947#comments</comments>
		<pubDate>Wed, 02 May 2012 13:00:56 +0000</pubDate>
		<dc:creator>Scott Nesbitt</dc:creator>
				<category><![CDATA[books]]></category>
		<category><![CDATA[technical communication]]></category>
		<category><![CDATA[wiki]]></category>

		<guid isPermaLink="false">http://www.dmncommunications.com/weblog/?p=2947</guid>
		<description><![CDATA[Wikis have been part of my professional freelance writing and technical communication lives for a number of years now. I&#8217;ve used them extensively and even maintain my own wiki; I&#8217;ve written with and about them; and I&#8217;ve even set up &#8230; <a href="http://www.dmncommunications.com/weblog/?p=2947">Continue reading <span class="meta-nav">&#8594;</span></a>]]></description>
			<content:encoded><![CDATA[<div class="tweetmeme_button" style="float: right; margin-left: 10px;">
			<a href="http://api.tweetmeme.com/share?url=http%3A%2F%2Fwww.dmncommunications.com%2Fweblog%2F%3Fp%3D2947"><br />
				<img src="http://api.tweetmeme.com/imagebutton.gif?url=http%3A%2F%2Fwww.dmncommunications.com%2Fweblog%2F%3Fp%3D2947&amp;source=dmnguys&amp;style=compact&amp;service=bit.ly&amp;service_api=R_6b2d5379b04edb8e4ce172df33b67539&amp;b=2" height="61" width="50" /><br />
			</a>
		</div>
<p><img class="alignleft size-full wp-image-2948" title="Confluence, Tech Comm, Chocolate" src="http://www.dmncommunications.com/weblog/wp-content/uploads/2012/05/CTCC-Cover-Front-195x240.png" alt="Confluence, Tech Comm, Chocolate" width="195" height="240" align="left" /> Wikis have been part of my professional freelance writing and technical communication lives for a number of years now. I&#8217;ve used them extensively and even maintain my own wiki; I&#8217;ve written with and about them; and I&#8217;ve even set up a few documentation wikis. While a couple or three people have generously suggested that I&#8217;m an expert in this area, I&#8217;m not. Far from it, in fact. I still have a lot to learn.</p>
<p>To do that, I turn to others who know <em>a lot</em> more about wikis than I do. Folks like Stewart Mader, Alan J. Porter, and Sarah Maddox. And it&#8217;s Sarah Maddox, or at least her new book, that sparked this blog post.</p>
<p>Being the aging, jaded person I am I don&#8217;t get excited about much. When I learned that Sarah was working on a book on using wikis specifically for writing documentation I got excited. As a technical writer for Atlassian (the folks behind the Confluence wiki), Sarah lives documentation and wikis &#8212; all of Atlassian&#8217;s documentation is delivered with a wiki. I was expecting a comprehensive look at using a wiki for documentation. And I wasn&#8217;t disappointed.</p>
<p>Let&#8217;s take a closer look at <em><a href="http://xmlpress.net/publications/chocolate/">Confluence, Tech Comm, Chocolate</a></em>.</p>
<p><span id="more-2947"></span></p>
<h3>Jumping in</h3>
<p><em>Confluence, Tech Comm, Chocolate</em> is an end-to-end tutorial on using a wiki for documentation, written in a lively style. It starts off with an introduction to wikis and takes you on a quick tour of Confluence. From there, your learning begins. Each chapter is a lesson, walking you through what you&#8217;ll need to know to successfully use a wiki to write, edit, review, and deliver documentation. At end of each chapter is a recap of important points that were covered, along with more than a few references.</p>
<p>As I said a moment ago, the book is written in a style that&#8217;s easy to read and never boring. Walking you through the book is a character that Sarah created named Ganache. She&#8217;s a technical writer (surprise, surprise!) and it&#8217;s through the filter of Ganache&#8217;s experience that you see how to effectively set up a wiki for documentation.</p>
<p>Be warned that this isn&#8217;t a short book. <em>Confluence, Tech Comm, Chocolate</em> weighs in at 477 pages. But unless you&#8217;re an expert wiki user, you&#8217;ll learn something from many of those pages. It&#8217;s also heavily slanted towards users of Confluence. But you can apply the information in the book to other wikis. More on this in a bit.</p>
<p>Now that the preliminaries are out of the way, let&#8217;s jump into some of the section of <em>Confluence, Tech Comm, Chocolate</em> that I found interesting and useful.</p>
<h3>Writing and structuring information</h3>
<p>Well written and well structured documentation is far more useful to readers than unrelated bits of content. As Sarah writes:</p>
<blockquote><p>Isn&#8217;t a wiki just a puddle of chaos? Doesn&#8217;t it always look like an unimaginative scrabble of words, with no form to enhance the meaning? Not necessarily!</p></blockquote>
<p>To help you avoid creating that <em>puddle of chaos</em>, Sarah spends several chapters looking at how to plan, structure, and create content on a wiki. That involves planning your wiki, changing its appearance because <a href="http://www.dmncommunications.com/weblog/?p=1777">looks can matter</a>, and to reuse content whenever possible.</p>
<p>Also, wikis are prime candidates for creating documentation via topic-based writing. Each page can be a discrete piece of content, connected with other content via links and cross references. Just about anything you can do in tools like FrameMaker or Flare, you can do on a wiki. Including delivering online help, a subject to which Sarah devotes an entire chapter.</p>
<h3>Engaging your audience</h3>
<p>As I keep pointing out to people (some of whom should know better), technical communicators aren&#8217;t creating documentation for themselves. We have an audience that we need to engage and capture. That&#8217;s not easy. But luckily there are tools out there to help us.</p>
<p>Like what? Like social media, for example. As Sarah points out:</p>
<blockquote><p>Social media offers new ways for getting readers involved in the documentation and for getting technical communicators involved with their readers. Never before has it been so easy to engage with so many people at once.</p></blockquote>
<p>How? By:</p>
<ul>
<li>Making readers aware that the documentation exists.</li>
<li>Getting feedback from readers.</li>
<li>Influencing what people say and think about documentation.</li>
<li>Making documentation one of the first, if not the first, point of contact</li>
</ul>
<p>You can do that, as Sarah points out, by not only getting the attention of internal teams and bloggers on the wider web, but also by using tools like Twitter to publish tips and point to information that readers can use.</p>
<p>But engaging your audience doesn&#8217;t stop with pulling them into your documentation. If you can, get them involved in leaving comment or, even better, adding to the documentation. Even nowadays, I know more than a few technical communicators who are loathe to allow reader to touch <em>their</em> documentation. But as I pointed out earlier and elsewhere, it&#8217;s not our documentation. We&#8217;re writing it for our readers, and many of them have insights that we can use to improve those docs.</p>
<p>Sarah devotes a whole chapter to this, called &#8220;Updates by everyman,&#8221; and offers some solid advice on why you&#8217;d want to involve your readers in updates, as well as information on copyrights and intellectual property. That chapter cleared up some of the questions on this subject that have been nagging me for a while.</p>
<h3>But I don&#8217;t use Confluence &#8230;</h3>
<p>So what?</p>
<p>I read a short review of <em>Confluence, Tech Comm, Chocolate</em> at an online bookseller. The person who wrote that review claimed that he couldn&#8217;t figure out how to apply the lessons of this book to other wikis. That left me scratching my head. Sure, this book is filled with examples of the features and functions related to Confluence but if you know your wiki (or are willing to learn about it) then you can adapt a lot of the information in this book to your tool of choice. Like what? How about, for example:</p>
<ul>
<li><strong>Plugins</strong> &#8212; Most wikis support them. And while they might not be as powerful or as flexible or even as numerous as the ones available for Confluence, chances are you can find plugins that suit your needs. <a href="http://www.dokuwiki.org">DokuWiki</a>, for example has plugins that enable you to <a href="http://www.dokuwiki.org/plugin:bookcreator">create a book</a> by selecting various pages or to <a href="http://www.dokuwiki.org/plugin:svgedit">create and edit SVG</a> images.</li>
<li><strong>Namespaces</strong> &#8212; All wikis support namespaces. Namespaces enable you put compartmentalize your documentation. You can have namespaces for user guides, administrator guides, and online help. Never the twain shall meet, unless you explicitly link between them.</li>
<li><strong>Importing content</strong> &#8212; Not all wikis support this, but the ones that do often do it well. <a href="http://www.mindtouch.com">MindTouch</a>, for example, has a feature that lets you <a href="http://help.mindtouch.us/MindTouch_Pro_Member_Guide/007_The_More_Menu/Importing_a_.CHM_File_into_MindTouch_using_Desktop_Connector">import a CHM file</a>.</li>
<li><strong>Content reuse</strong> &#8212; A lot like snippets in Madcap Flare or insets in FrameMaker, most wikis allow you to reuse content. You can read about how I did that with Twiki <a href="http://www.dmncommunications.com/weblog/?p=387">here</a>.</li>
</ul>
<p>And those are just the examples that popped into my head as I was writing this post.</p>
<p>The lessons of this book aren&#8217;t restricted to the tool. Earlier, I mentioned the chapters which discuss how to engage readers. And if you can&#8217;t find a way to take the information in chapters 6 and 7 (on developing content and structure &amp; style, respectively) then I suggest you find someone who can.</p>
<p>Adapting the information in <em>Confluence, Tech Comm, Chocolate</em> to your wiki might take a bit of time and thought, but it&#8217;s worth taking that time and doing that thinking.</p>
<h3>OK, where does chocolate come in?</h3>
<p>If you&#8217;ve ever read any of Sarah&#8217;s <a href="http://ffeathers.wordpress.com/">blog posts</a> or <a href="http://twitter.com/#!/sarahmaddox">tweets</a>, you know that chocolate plays a role in her personal and professional lives. It&#8217;s a treat. It&#8217;s a good energy boost. And it&#8217;s a good way to engage (I hate to use the word <em>bribe</em>) developers and subject matter experts.</p>
<p>Throughout the book, you&#8217;ll find little sidebars containing quotes from various technical communicators on what role chocolate plays in their professional lives. If nothing else, those sidebars offer a nice break. And some good ideas for snacks!</p>
<h3>Summing up</h3>
<p>While I read the book from cover to cover (except for the index), I didn&#8217;t look at everything in the <em>Confluence, Tech Comm, Chocolate</em> in this review<em>.</em> There&#8217;s a lot more between the covers than what I&#8217;ve outlined above. And it&#8217;s useful whether you&#8217;re new to using wikis for documentation or if you&#8217;re an experienced hand.</p>
<p><em>Confluence, Tech Comm, Chocolate</em> bridges the gap between the theoretical and practical sides of implementing a wiki for documentation. And its tech comm focus is something that makes it an excellent companion to books like <em><a href="http://www.amazon.com/Wikipatterns-Stewart-Mader/dp/0470223626/ref=bxgy_cc_b_img_b">WikiPatterns</a></em>, <em><a href="http://www.dmncommunications.com/weblog/?p=1925">Writing in the Open</a></em>, and <em><a href="http://www.dmncommunications.com/weblog/?p=2321">WIKI: Grow Your Own for Fun and Profit</a></em>. If you&#8217;re a technical communicator looking for solid, practical advice on implementing a wiki for documentation then grab a copy of this book. You won&#8217;t regret it.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.dmncommunications.com/weblog/?feed=rss2&amp;p=2947</wfw:commentRss>
		<slash:comments>3</slash:comments>
		</item>
		<item>
		<title>Using Evernote Web Clipper and Clearly as research tools</title>
		<link>http://www.dmncommunications.com/weblog/?p=2939</link>
		<comments>http://www.dmncommunications.com/weblog/?p=2939#comments</comments>
		<pubDate>Mon, 19 Mar 2012 13:00:00 +0000</pubDate>
		<dc:creator>Scott Nesbitt</dc:creator>
				<category><![CDATA[tools]]></category>

		<guid isPermaLink="false">http://www.dmncommunications.com/weblog/?p=2939</guid>
		<description><![CDATA[Research. It’s the life blood of any writer. No matter what you’re doing – journalism, blogging, penning fiction, or doing any kind of technical or corporate writing – you need to gather facts and information. Of course, the nature of &#8230; <a href="http://www.dmncommunications.com/weblog/?p=2939">Continue reading <span class="meta-nav">&#8594;</span></a>]]></description>
			<content:encoded><![CDATA[<div class="tweetmeme_button" style="float: right; margin-left: 10px;">
			<a href="http://api.tweetmeme.com/share?url=http%3A%2F%2Fwww.dmncommunications.com%2Fweblog%2F%3Fp%3D2939"><br />
				<img src="http://api.tweetmeme.com/imagebutton.gif?url=http%3A%2F%2Fwww.dmncommunications.com%2Fweblog%2F%3Fp%3D2939&amp;source=dmnguys&amp;style=compact&amp;service=bit.ly&amp;service_api=R_6b2d5379b04edb8e4ce172df33b67539&amp;b=2" height="61" width="50" /><br />
			</a>
		</div>
<p><img class="alignleft size-full wp-image-2940" title="Evernote" src="http://www.dmncommunications.com/weblog/wp-content/uploads/2012/03/evernote_logo_center_4c-lrg.gif" alt="Evernote" width="228" height="118" align="left" /> Research. It’s the life blood of any writer. No matter what you’re doing – journalism, blogging, penning fiction, or doing any kind of technical or corporate writing – you need to gather facts and information.</p>
<p>Of course, the nature of research has morphed since I went pro all those many years ago. I remember spending a lot of time in the library or on the phone digging up information. Then, the Internet came to our computers and changed the game.</p>
<p>In the early days, researching on the web involved either copying and pasting information into a text editor or word processor file, or jotting notes on to paper. Thanks to web-based note taking applications like <a href="http://www.evernote.com">Evernote</a>, that became a whole lot easier.</p>
<p>But copying and pasting information into Evernote isn’t the most efficient way to do things. Why not let your browser and Evernote work together? You can do that with two browser extensions for Evernote called Web Clipper and Clearly.</p>
<p>Let’s take a closer look at them and how they can be a useful addition to the tool kit of any writer, technical or otherwise.</p>
<p><span id="more-2939"></span></p>
<h3>Web Clipper</h3>
<p>Evernote <a href="https://www.evernote.com/about/trunk/items/evernote-clippers?lang=en&amp;layout=default&amp;source=desktop_page">Web Clipper</a> does just what it says: it clips information from a web page and saves it to your Evernote account.</p>
<p>All you need to do is install it and you’re literally a mouse click away from saving useful or interesting information that you find on the web.</p>
<p>When you install Web Clipper, it adds an icon to your browser’s tool bar. Here’s what it looks like in Chrome:</p>
<p><img class="aligncenter size-full wp-image-2941" title="Web Clipper tool bar" src="http://www.dmncommunications.com/weblog/wp-content/uploads/2012/03/clipper_toobar.png" alt="Web Clipper tool bar" width="277" height="33" /></p>
<p>When you’re on a web page containing information that you want to save, just click the icon. After a second or so, a small window opens.</p>
<p><a href="http://www.dmncommunications.com/weblog/wp-content/uploads/2012/03/evernote_web_clipper.png"><img class="aligncenter size-medium wp-image-2942" title="Clipping a page" src="http://www.dmncommunications.com/weblog/wp-content/uploads/2012/03/evernote_web_clipper-300x175.png" alt="Clipping a page" width="300" height="175" /></a></p>
<p>Here, you can do a number of things like:</p>
<ul>
<li>Choose the Evernote notebook in which you want to save the page.</li>
<li>Add tags or comments to the note. Tags make it easier to find notes in Evernote, and you can use comments to note where you found the information.</li>
<li>Choose whether you want to clip the article, the entire page, or just the URL.</li>
</ul>
<p>When you choose to clip the ariticle, Web Clipper only copies the text and any graphics in the main portion of the page. Choosing to grab the entire page … well, grabs <em>everything</em>. Cruft and all.</p>
<p>I have two minor beefs with Web Clipper. The first is that it sometimes doesn’t give you every option for grabbing content. Sometimes, you can only grab a URL or the entire page. Sometimes, everything. Not a big deal, I admit, but sometimes that can be frustrating. The second is that it’s all or nothing – you can’t just grab a selection from an article or web page.</p>
<h3>Using Clearly</h3>
<p>Remember when I mentioned that you can grab full web pages, cruft and all, with Web Clipper? I don’t know about you, but often that cruft annoys me. And not just when I’m clipping information to Evernote.</p>
<p>All of those additional page elements – like graphics and ads – are distracting. They can slow my reading down. Especially when I’m reading on my Chromebook, my smartphone, or my <a href="http://www.samsung.com/us/mobile/mp3-players/YP-G70CWY/XAA">media player</a>. Which is why the folks at Evernote came up with <a href="https://www.evernote.com/clearly/">Clearly</a>. Clearly …</p>
<blockquote><p>… makes blog posts, articles and webpages clean and easy to read</p></blockquote>
<p>Like Web Clipper, when you install Clearly you get an icon on your tool bar which looks like this:</p>
<p><img class="aligncenter size-full wp-image-2943" title="Clearly tool bar" src="http://www.dmncommunications.com/weblog/wp-content/uploads/2012/03/clearly_toolbar.png" alt="Clearly tool bar" width="277" height="33" /></p>
<p>Click the icon and Clearly creates a version of the page with only the text of the page and any graphics. All the cruft is removed.</p>
<p><a href="http://www.dmncommunications.com/weblog/wp-content/uploads/2012/03/evernote_clearly.png"><img class="aligncenter size-medium wp-image-2944" title="A web page without the cruft" src="http://www.dmncommunications.com/weblog/wp-content/uploads/2012/03/evernote_clearly-300x183.png" alt="A web page without the cruft" width="300" height="183" /></a></p>
<p>That’s a lot easier to read, wouldn’t you say?</p>
<h3>Combining Clearly with Web Clipper</h3>
<p>Clearly comes with its own clipping tool. I don’t like it all that much – it only saves the content to Evernote. There’s nothing wrong with that, but I prefer to be able to choose the destination notebook and to add tags or comments <em>before</em> I save a clip.</p>
<p>Guess what? You can use Web Clipper with Clearly. They make a powerful pair. Just give a Web page or article or blog post the Clearly treatment, then click the Web Clipper icon. Choose your options, and save the clip.</p>
<p>You get the best of both worlds – the ease of reading of Clearly and the flexibility of Web Clipper. And all it takes is a couple of clicks and a few keystrokes.</p>
<p>I’ve been using Clearly and Web Clipper together since Clearly made it’s appearance a few months back. It’s made reviewing information on my mobile devices, and reading on both those devices and my laptops, a lot easier.</p>
<p>The ability to add tags and comments is useful, too. Tags I’ve mentioned before. With comments, I’ve gone beyond using them just to note where I found some useful text. I’ve also started using comments to pinpoint where in an article or post the information I’ve dug up should go, or to note a paragraph containing something worth using.</p>
<p>Do you use Clearly and Web Clipper? How are you using them? Share your ideas by leaving a comment.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.dmncommunications.com/weblog/?feed=rss2&amp;p=2939</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Breaking free of your comfort zone</title>
		<link>http://www.dmncommunications.com/weblog/?p=2936</link>
		<comments>http://www.dmncommunications.com/weblog/?p=2936#comments</comments>
		<pubDate>Mon, 12 Mar 2012 13:00:42 +0000</pubDate>
		<dc:creator>Scott Nesbitt</dc:creator>
				<category><![CDATA[advice]]></category>
		<category><![CDATA[career]]></category>

		<guid isPermaLink="false">http://www.dmncommunications.com/weblog/?p=2936</guid>
		<description><![CDATA[Falling into a nice little rut. Getting complacent. Finding a comfortable groove. Wrapping yourself in a cloak of familiarity. Call it what you will, but most of us fall into the comfort of a routine now and then. Yes, the &#8230; <a href="http://www.dmncommunications.com/weblog/?p=2936">Continue reading <span class="meta-nav">&#8594;</span></a>]]></description>
			<content:encoded><![CDATA[<div class="tweetmeme_button" style="float: right; margin-left: 10px;">
			<a href="http://api.tweetmeme.com/share?url=http%3A%2F%2Fwww.dmncommunications.com%2Fweblog%2F%3Fp%3D2936"><br />
				<img src="http://api.tweetmeme.com/imagebutton.gif?url=http%3A%2F%2Fwww.dmncommunications.com%2Fweblog%2F%3Fp%3D2936&amp;source=dmnguys&amp;style=compact&amp;service=bit.ly&amp;service_api=R_6b2d5379b04edb8e4ce172df33b67539&amp;b=2" height="61" width="50" /><br />
			</a>
		</div>
<p><img class="alignleft size-full wp-image-2937" title="explore" src="http://www.dmncommunications.com/weblog/wp-content/uploads/2012/03/explore.jpg" alt="explore" width="160" height="120" align="left" /> Falling into a nice little rut. Getting complacent. Finding a comfortable groove. Wrapping yourself in a cloak of familiarity.</p>
<p>Call it what you will, but most of us fall into the comfort of a routine now and then. Yes, the oft-talked-about <em>comfort zone</em>.</p>
<p>There’s nothing wrong with that. But I find that inhabiting the comfort zone can get boring. Actually, worse than boring. You’ve probably felt the same way. The work is easy to do and feels more like typing than actual writing. Or, you feel the need to move into areas other than just pure technical writing.</p>
<p>Lately, I’ve been feeling that I’ve ensconced too snugly in my own comfort zone. As part of something I call <em>Phase 3</em> (more on this in the coming months) and as part of the New Cruelty, I’ve been experimenting with ways of bursting free of my comfort zone.</p>
<p>You can burst out of yours too. And doing that just might refresh you, your technical writing, and your career.</p>
<p>Curious? Then read on.</p>
<p><span id="more-2936"></span></p>
<h3>Proceeding with a plan</h3>
<p>Moving out of your comfort zone is difficult. It takes a conscious effort. To do it effectively, you need a plan.</p>
<p>Your plan doesn’t need to be elaborate or detailed; it can be, though. Just think about what you want to do and then start with small steps down that road.</p>
<p>Like what? For example, maybe you primarily work on user documentation for enterprise applications. To move outside that comfort zone, you might consider blogging or writing short manuals or articles for commercial products. Start small. Write short pieces using language that’s more casual than what you’d use with your usual audience. Then move on to writing longer pieces.</p>
<p>Or consider contributing to an Open Source project like <a href="http://flossmanuals.net">FLOSS Manuals</a>. Whenever I take part in or facilitate a <a href="http://www.booksprints.net/">book sprint</a>, I get a different perspective on documentation. I also feel a bit less jaded about my profession and even learn a thing or two.</p>
<p>Get into the rhythm of what you want to write, then build up.</p>
<h3>Moving off on a tangent</h3>
<p>Earlier, I mentioned Phase 3. It’s going to be a big change in my life, one that some of the fives of people who read this blog know about.</p>
<p>As part of Phase 3, I’m seriously considering moving into a couple of areas that are <em>really</em> outside my comfort zone. They involve writing to a degree, but also skills that I don’t currently have. This is where the New Cruelty comes in: trying to pick up those skills.</p>
<p>(If you want the details, you’ll need to wait a little while. I don’t talk about plans that I’m currently formulating. Nothing personal …)</p>
<p>As I wrote a couple of paragraphs ago, I’m planning on doing one or two things that interest me but which outside of my usual sphere. It’s not going to be easy, but I sure am going to try.</p>
<p>You can, too. Maybe you want to add photography or technical illustration or writing API documentation to your set of skills. The only way to do that is to learn. And practice. And practice some more. It will definitely take effort. And it could be expensive.</p>
<p>The rewards, though, are definitely worth it.</p>
<h3>Expect to fail</h3>
<p>I can tell you from experience that not everything you try will work out. In fact, failure is a distinct option.</p>
<p>And that’s fine. Don’t let failure get you down.</p>
<p>Failure is useful. Failure is instructive. Failure helps you grow.</p>
<p>Breaking out of your comfort zone isn’t just something you should try. Sometimes, it’s something that you need to do. It will make you a better, more rounded person and writer.</p>
<p>Thoughts? As always, your comments are welcome.</p>
<p>Photo credit: <a href="http://www.sxc.hu/profile/samplediz">samplediz</a></p>
]]></content:encoded>
			<wfw:commentRss>http://www.dmncommunications.com/weblog/?feed=rss2&amp;p=2936</wfw:commentRss>
		<slash:comments>1</slash:comments>
		</item>
		<item>
		<title>Weekly links roundup</title>
		<link>http://www.dmncommunications.com/weblog/?p=2932</link>
		<comments>http://www.dmncommunications.com/weblog/?p=2932#comments</comments>
		<pubDate>Fri, 09 Mar 2012 13:00:55 +0000</pubDate>
		<dc:creator>DMN Communications</dc:creator>
				<category><![CDATA[links]]></category>

		<guid isPermaLink="false">http://www.dmncommunications.com/weblog/?p=2932</guid>
		<description><![CDATA[How mobile networks and app developers affect user experience If John Henry was a technical writer and not a steel-driving man &#8230; An interesting musing on the help system of the future Concept or reference, what&#8217;s the difference? What developers &#8230; <a href="http://www.dmncommunications.com/weblog/?p=2932">Continue reading <span class="meta-nav">&#8594;</span></a>]]></description>
			<content:encoded><![CDATA[<div class="tweetmeme_button" style="float: right; margin-left: 10px;">
			<a href="http://api.tweetmeme.com/share?url=http%3A%2F%2Fwww.dmncommunications.com%2Fweblog%2F%3Fp%3D2932"><br />
				<img src="http://api.tweetmeme.com/imagebutton.gif?url=http%3A%2F%2Fwww.dmncommunications.com%2Fweblog%2F%3Fp%3D2932&amp;source=dmnguys&amp;style=compact&amp;service=bit.ly&amp;service_api=R_6b2d5379b04edb8e4ce172df33b67539&amp;b=2" height="61" width="50" /><br />
			</a>
		</div>
<ul>
<li>How <a href="http://www.uxbooth.com/blog/how-mobile-networks-and-app-developers-affect-the-user-experience/">mobile networks and app developers</a> affect user experience</li>
<li>If John Henry <a href="http://www.helpscribe.com/2012/03/man-versus-machine-if-john-henry-was.html">was a technical writer</a> and not a steel-driving man &#8230;</li>
<li>An interesting musing on <a href="http://www.tcworld.info/tcworld/technical-communication/article/the-help-system-of-the-future/">the help system of the future</a></li>
<li><a href="http://kaiweber.wordpress.com/2012/03/05/concept-or-reference-whats-the-difference/">Concept or reference</a>, what&#8217;s the difference?</li>
<li>What <a href="http://ffeathers.wordpress.com/2012/03/04/what-developers-want/">developers want</a></li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://www.dmncommunications.com/weblog/?feed=rss2&amp;p=2932</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Using topic-based writing to pull together any writing project</title>
		<link>http://www.dmncommunications.com/weblog/?p=2928</link>
		<comments>http://www.dmncommunications.com/weblog/?p=2928#comments</comments>
		<pubDate>Mon, 05 Mar 2012 13:00:12 +0000</pubDate>
		<dc:creator>Scott Nesbitt</dc:creator>
				<category><![CDATA[advice]]></category>
		<category><![CDATA[techniques]]></category>
		<category><![CDATA[writing]]></category>

		<guid isPermaLink="false">http://www.dmncommunications.com/weblog/?p=2928</guid>
		<description><![CDATA[I don&#8217;t have to tell you that topic-based writing is a very popular idea in the world of technical communication. And with good reason: it can help make writing, managing, and assembling documentation a lot easier. But you can apply &#8230; <a href="http://www.dmncommunications.com/weblog/?p=2928">Continue reading <span class="meta-nav">&#8594;</span></a>]]></description>
			<content:encoded><![CDATA[<div class="tweetmeme_button" style="float: right; margin-left: 10px;">
			<a href="http://api.tweetmeme.com/share?url=http%3A%2F%2Fwww.dmncommunications.com%2Fweblog%2F%3Fp%3D2928"><br />
				<img src="http://api.tweetmeme.com/imagebutton.gif?url=http%3A%2F%2Fwww.dmncommunications.com%2Fweblog%2F%3Fp%3D2928&amp;source=dmnguys&amp;style=compact&amp;service=bit.ly&amp;service_api=R_6b2d5379b04edb8e4ce172df33b67539&amp;b=2" height="61" width="50" /><br />
			</a>
		</div>
<p><img class="alignleft size-full wp-image-2929" title="Pulling it all together" src="http://www.dmncommunications.com/weblog/wp-content/uploads/2012/03/pieces.jpg" alt="Pulling it all together" width="160" height="107" align="left" /> I don&#8217;t have to tell you that topic-based writing is a <em>very</em> popular idea in the world of technical communication. And with good reason: it can help make writing, managing, and assembling documentation a lot easier.</p>
<p>But you can apply topic-based writing to work outside of our profession.</p>
<p>As you may or may not know, I do quite a bit of freelance writing. And sometimes, I have an idea for a non-fiction writing project, but am only able to chip away at it bit by bit? That sometimes feels like it happens a bit too often.</p>
<p>I also find that with projects like that, I write in bits and pieces &#8212; a few sentences or paragraphs here and there &#8212; and never get anything finished. I have chunks of writing, but can&#8217;t really pull them together.</p>
<p>Yes, that&#8217;s where topic-based writing comes into play. It can help you pull together all those chunks of content that you&#8217;ve been pecking out into something tangible.</p>
<p>Have I got your attention? Then read on.</p>
<p><span id="more-2928"></span></p>
<h3>Topic-based writing: a quick refresher</h3>
<p>If you&#8217;re familiar with the subject, or if you use topic-based writing in your daily work, feel skip this section.</p>
<p>With topic-based writing, a piece of documentation is broken down into its component parts. Each of those components is called, as you&#8217;ve guessed, a <em>topic</em>. A topic can be a lump of overview information, a procedure, and the like. It can be a single sentence, one or more paragraphs, or longer.</p>
<p>Each topic stands on its own. It&#8217;s not related to, or reliant upon, any of the topics that come before or after it. You can stitch topics together in a number of very interesting and unique ways.</p>
<p>As far as documentation goes, you can have a store of topics. Then, you can combine them to create various types of manuals.</p>
<h3>Applying this to other writing</h3>
<p>That&#8217;s all well and good for technical writing. But how can you apply this concept to other forms of non-fiction writing? Actually, that&#8217;s fairly easy.</p>
<p>Take all of those bits and pieces that you&#8217;ve been writing &#8212; whether they&#8217;re in text files, word processor documents, or in a paper notebook. Treat those bits and pieces as topics. Then combine them into one large document. Of course, you&#8217;ll want to put them into a logical order &#8230;</p>
<p>Chances are, you&#8217;ll have at least an article&#8217;s worth of content. The problem you&#8217;ll encounter is that after you&#8217;ve stitched all of those topics together, the final product will seem very disjointed. That&#8217;s one weakness of topic-based writing. However, that&#8217;s a problem that&#8217;s easy to get around. Just add segues and linking material wherever it&#8217;s needed.</p>
<h3>A real-world example</h3>
<p>No, this isn&#8217;t all theory. I&#8217;ve used topic-based writing with other forms of non-fiction. How?</p>
<p>A while back, I had a tough week or so that took its toll on my writing. In fact, there was a day that I officially declared a write off. Definitely not a happy thing when you’re staring down the barrels of several deadlines.</p>
<p>One article in particular was rather slow in coming. It was an assignment from a gadget magazine: I had to write a 1,200 word article on 10 recommended gadgets for Christmas. One hundred words per gadget, plus recommendations and introductory and concluding material. That’s not a lot of space, but it wasn’t a problem. I’ve done articles like that before.</p>
<p>But those 100 words &#8230; They didn’t seem to want to come the way they usually do. And to keep each description in the 100 word limit, I decided not to fool around in word processor with word counts.</p>
<p>I wrote each description in a text editor, and saved those descriptions in individual text files. Doing that made it easier to reach and stay within the word count for each gadget.</p>
<p>Once everything was written, I pulled the files together and pasted them into a word processor. I was able to do this quickly and easily because there was no linking material between each description. All I needed to do was add a little information to beginning and to the end.</p>
<p>Since then, I&#8217;ve done that a few more times. And, guess what? Topic-based writing not only saved my bacon, it made getting the work done a lot easier.</p>
<p>In fact, one of the ebooks I&#8217;m working on (titled <em>Project A</em>) is being written using the topic-based technique. Each chapter is a topic. That gives me a lot of flexibility in arranging and re-arranging the order of chapters. I don&#8217;t have to worry about re-writing connecting material. Once I&#8217;ve found the optimal mix, I can add that material and then publish.</p>
<h3>Taking this a step or two further</h3>
<p>By tackling one or more writing projects in this way, you&#8217;re opening the door to creating a library of topics. You can use what&#8217;s in that library to quickly assemble articles, or target existing ideas (with a few changes) to multiple markets.</p>
<p>The biggest problem you&#8217;ll face is that you&#8217;ll have a hard time keeping track of all of your topics once your library begins to grow.</p>
<p>Thoughts? Feel free to leave a comment.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.dmncommunications.com/weblog/?feed=rss2&amp;p=2928</wfw:commentRss>
		<slash:comments>3</slash:comments>
		</item>
		<item>
		<title>Weekly links roundup</title>
		<link>http://www.dmncommunications.com/weblog/?p=2923</link>
		<comments>http://www.dmncommunications.com/weblog/?p=2923#comments</comments>
		<pubDate>Fri, 02 Mar 2012 13:00:51 +0000</pubDate>
		<dc:creator>DMN Communications</dc:creator>
				<category><![CDATA[links]]></category>

		<guid isPermaLink="false">http://www.dmncommunications.com/weblog/?p=2923</guid>
		<description><![CDATA[A day in the life of a technical writer User documentation, from the perspective of an accountant Find out how people use your documentation A good overview of tools for building ebooks Thoughts on the segmentation of technical communication]]></description>
			<content:encoded><![CDATA[<div class="tweetmeme_button" style="float: right; margin-left: 10px;">
			<a href="http://api.tweetmeme.com/share?url=http%3A%2F%2Fwww.dmncommunications.com%2Fweblog%2F%3Fp%3D2923"><br />
				<img src="http://api.tweetmeme.com/imagebutton.gif?url=http%3A%2F%2Fwww.dmncommunications.com%2Fweblog%2F%3Fp%3D2923&amp;source=dmnguys&amp;style=compact&amp;service=bit.ly&amp;service_api=R_6b2d5379b04edb8e4ce172df33b67539&amp;b=2" height="61" width="50" /><br />
			</a>
		</div>
<ul>
<li>A <a href="http://blogs.atlassian.com/2012/03/a-day-in-the-life-of-a-technical-writer/">day in the life</a> of a technical writer</li>
<li>User documentation, from the <a href="http://www.cherryleaf.com/blog/2012/02/user-documentation-from-an-accountants-perspective/">perspective of an accountant</a></li>
<li>Find out how people <a href="http://kaiweber.wordpress.com/2012/02/27/find-out-how-users-use-your-documentation/">use your documentation</a></li>
<li>A good overview of <a href="http://techwhirl.com/skills/delivery/e-books/building-e-books-a-tool-overview-for-technical-writers/">tools for building ebooks</a></li>
<li>Thoughts on the <a href="http://everypageispageone.com/2012/02/16/the-segmentation-of-tech-comm/">segmentation of technical communication</a></li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://www.dmncommunications.com/weblog/?feed=rss2&amp;p=2923</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Rolling with the punches</title>
		<link>http://www.dmncommunications.com/weblog/?p=2918</link>
		<comments>http://www.dmncommunications.com/weblog/?p=2918#comments</comments>
		<pubDate>Mon, 27 Feb 2012 13:00:39 +0000</pubDate>
		<dc:creator>Scott Nesbitt</dc:creator>
				<category><![CDATA[advice]]></category>
		<category><![CDATA[career]]></category>
		<category><![CDATA[freelance]]></category>

		<guid isPermaLink="false">http://www.dmncommunications.com/weblog/?p=2918</guid>
		<description><![CDATA[Ever been stung (professionally) in a way that you thought would never happen to you? It happened to me December, 2010. It was a bit shock, let me tell you. Take a moment, sit back, and let Uncle Scotty tell &#8230; <a href="http://www.dmncommunications.com/weblog/?p=2918">Continue reading <span class="meta-nav">&#8594;</span></a>]]></description>
			<content:encoded><![CDATA[<div class="tweetmeme_button" style="float: right; margin-left: 10px;">
			<a href="http://api.tweetmeme.com/share?url=http%3A%2F%2Fwww.dmncommunications.com%2Fweblog%2F%3Fp%3D2918"><br />
				<img src="http://api.tweetmeme.com/imagebutton.gif?url=http%3A%2F%2Fwww.dmncommunications.com%2Fweblog%2F%3Fp%3D2918&amp;source=dmnguys&amp;style=compact&amp;service=bit.ly&amp;service_api=R_6b2d5379b04edb8e4ce172df33b67539&amp;b=2" height="61" width="50" /><br />
			</a>
		</div>
<p><img class="alignleft size-full wp-image-2919" title="No, my hair's not blue ..." src="http://www.dmncommunications.com/weblog/wp-content/uploads/2012/02/punches.jpg" alt="No, my hair's not blue ..." width="160" height="207" align="left" /> Ever been stung (professionally) in a way that you thought would never happen to you? It happened to me December, 2010. It was a bit shock, let me tell you.</p>
<p>Take a moment, sit back, and let Uncle Scotty tell you one of his stories:</p>
<p>In November of that year, I started a six-month technical writing contract with a financial firm here in Toronto. The pay, while not the greatest, wasn&#8217;t too bad. And having that firm on the client list wouldn&#8217;t have hurt either. During the weeks that followed, I got a lot of good feedback about my work and was making good progress on my project.</p>
<p>Then on a Wednesday in early December, 2010 (a month, to the day, from when I started, in case you&#8217;re wondering) I got a call from HR. I went to their offices and before the very agitated looking HR person could open her mouth, I said <em>I think I know what this is about</em>. Then, pointing to the envelope on her desk, I further perturbed the poor woman by saying <em>I assume that&#8217;s for me &#8230;</em></p>
<p>I, along with 3/5 of the company&#8217;s documentation team, was let go then and there. Another department or two had been gutted in the previous day or so, too. But I wasn&#8217;t worried. I&#8217;d been there before. This was the first time this happened as a contractor, though.</p>
<p>It being December, I knew that there wouldn&#8217;t be any longer-term gigs in the offing. Things usually slow down at around that time of year. But by scrambling, I was able to pull together enough short-term work to keep me going for a while.</p>
<p>Here are a few lessons I gleaned from that experience.</p>
<p><span id="more-2918"></span></p>
<p><strong>Have some money saved</strong>. Everyone advises people striking out on their own to have at least three months worth of expenses saved. Preferably more. Luckily, I&#8217;m one of those people who took that advice. I probably should have more saved (I&#8217;m working on it), but the cushion I had plus what I made with a number of freelance gigs will tide me over for the beginning of 2011 at least.</p>
<p><strong>Always keep your eyes open</strong>. Even when you have a gig or two. Always make sure that you know what the market is like and are ready to adapt. You never know when you&#8217;re going to have to roll with the punches. Preparation is the best defense, especially for the freelancer.</p>
<p><strong>Use your network</strong>. You probably know other freelancers, or have other clients or former clients. Don&#8217;t be afraid to contact them. It might seem like begging, but many of them understand. They&#8217;ve probably been there before. You never know what will happen. The worst thing they can say is <em>no</em>. But they won&#8217;t even say that if you don&#8217;t ask first.</p>
<p><strong>Don&#8217;t take the low-paying gig</strong>. Unless, of course, you can&#8217;t afford to do otherwise. If you can, avoid it. Taking low-paying gigs not only saps your energy (you have to write <em>a lot</em> to make even a half-decent amount) but drops you on a treadmill that can be tough to get off.</p>
<p><strong>Don&#8217;t give up</strong>. Sometimes it might take a while for you to snag that next gig. Don&#8217;t give into despair. It&#8217;ll be tough to hold back those negative thoughts. Yes, I am speaking from experience. Just trust in your ability. Keep trying; something will happen.</p>
<p>Thoughts? Feel free to leave a comment.</p>
<p align="right"><small>Photo credit: <a href="http://www.photoxpress.com/search-photos-author/catabu/792328">Catabu</a> from <a href="http://www.photoxpress.com/">Photoxpress</a></small></p>
]]></content:encoded>
			<wfw:commentRss>http://www.dmncommunications.com/weblog/?feed=rss2&amp;p=2918</wfw:commentRss>
		<slash:comments>2</slash:comments>
		</item>
		<item>
		<title>Storyboarding: not just for movies</title>
		<link>http://www.dmncommunications.com/weblog/?p=2908</link>
		<comments>http://www.dmncommunications.com/weblog/?p=2908#comments</comments>
		<pubDate>Mon, 20 Feb 2012 13:00:33 +0000</pubDate>
		<dc:creator>Scott Nesbitt</dc:creator>
				<category><![CDATA[technical communication]]></category>
		<category><![CDATA[techniques]]></category>

		<guid isPermaLink="false">http://www.dmncommunications.com/weblog/?p=2908</guid>
		<description><![CDATA[A time-honored technique among anyone making a movie is to create a storyboard. A storyboard is a shot-by-shot breakdown of each scene in the movie. It doesn&#8217;t need to be detailed. It just needs to show how each shot can &#8230; <a href="http://www.dmncommunications.com/weblog/?p=2908">Continue reading <span class="meta-nav">&#8594;</span></a>]]></description>
			<content:encoded><![CDATA[<div class="tweetmeme_button" style="float: right; margin-left: 10px;">
			<a href="http://api.tweetmeme.com/share?url=http%3A%2F%2Fwww.dmncommunications.com%2Fweblog%2F%3Fp%3D2908"><br />
				<img src="http://api.tweetmeme.com/imagebutton.gif?url=http%3A%2F%2Fwww.dmncommunications.com%2Fweblog%2F%3Fp%3D2908&amp;source=dmnguys&amp;style=compact&amp;service=bit.ly&amp;service_api=R_6b2d5379b04edb8e4ce172df33b67539&amp;b=2" height="61" width="50" /><br />
			</a>
		</div>
<p><img class="alignleft size-full wp-image-2910" title="Storyboard" src="http://www.dmncommunications.com/weblog/wp-content/uploads/2012/02/storyboard1.jpg" alt="Storyboard" width="160" height="120" align="left" /> A time-honored technique among anyone making a movie is to create a <a href="http://en.wikipedia.org/wiki/Storyboard">storyboard</a>. A storyboard is a shot-by-shot breakdown of each scene in the movie. It doesn&#8217;t need to be detailed. It just needs to show how each shot can be composed and how each scene can play out.</p>
<p>So what does this have to do with technical writing? Quite a bit. Storyboarding isn&#8217;t just for movies. You can use it for any kind of writing that has a visual flow, like screencasts or presentations.</p>
<p>I use storyboards when creating presentations and <a href="http://www.dmncommunications.com/weblog/?p=1614">screencasts</a>. Let me explain how.</p>
<p><span id="more-2908"></span></p>
<h3>Start with an outline</h3>
<p>If you know anything about the way in which I write, you know that I&#8217;m an advocate out outlining. An outline gives me a good start at building the structure of anything that I&#8217;m writing. As I work on the outline, I can often spot weak points in my idea or where I need to shift things around.</p>
<p>With presentations, an outline delineates each topic that I want to cover. Visually, one topic is one slide. With screencasts, the outline breaks down each step that I want to cover.</p>
<p>As with any outline:</p>
<ul>
<li><strong>Don&#8217;t over think it</strong>. It&#8217;s too easy to fall into the trap of trying to cover <em>everything</em>. That&#8217;s not possible, or even advisable. And it slows you down.</li>
<li><strong>Keep it fluid</strong>. Expect to do some rearranging and shifting.</li>
</ul>
<h3>Creating the storyboard</h3>
<p>You can do that on paper or with software. I use a <a href="http://www.moleskine.com/catalogue/classic/hard_black_cover/storyboard_notebook__pocket.php">Moleskine Storyboard Notebook</a>. You can also create a custom sheet of <a href="http://incompetech.com/graphpaper/storyboard/">storyboard paper</a> online and download it to your computer as a PDF file.</p>
<p>On the software side, check out <a href="http://celtx.com/">Celtx</a>, an Open Source tool for writing screenplays. It has a very good, and easy to use, storyboard feature.</p>
<p>When creating the storyboard, you don&#8217;t need to be detailed. Thumbnail sketches of what you want to do are often enough.</p>
<p>When I do a storyboard for a presentation, I point out ideas for the background of the slide and give information about the text (if any) on the slide. Here&#8217;s a sample (yes, I know it&#8217;s messy &#8230;):</p>
<p><a href="http://www.dmncommunications.com/weblog/wp-content/uploads/2012/02/notebook.jpg"><img class="aligncenter size-medium wp-image-2911" title="Storyboard notebook" src="http://www.dmncommunications.com/weblog/wp-content/uploads/2012/02/notebook-300x249.jpg" alt="Storyboard notebook" width="300" height="249" /></a></p>
<p>With a screencast, each shot on the storyboard consists of the screen (or the state of the screen) that I want to capture and explain. One shot can be me selecting an item from a menu, another one me entering text on the screen, and the like.</p>
<p>I sometimes go through two or three iterations of a storyboard &#8212; adding here, trimming there, tightening elsewhere. This helps me find the optimal flow.</p>
<p>Once that&#8217;s done, I create draft slides or do a first run through of the screencast. Usually, this is done in conjunction with the script I&#8217;ve written in parallel with the storyboard. Again, I&#8217;ll make minor tweaks until the final product is where I want it to be,</p>
<p>A storyboard seems like a lot of extra work. And it can be. But it&#8217;s also a great way to capture the visual flow of something you&#8217;re writing.</p>
<p>Thoughts? As always, your comments are welcome.</p>
<p align="right"><small>Photo credit: <a href="http://www.sxc.hu/profile/wlima">wlima</a> from <a href="http://www.sxc.hu/">stock.xchng</a></small></p>
]]></content:encoded>
			<wfw:commentRss>http://www.dmncommunications.com/weblog/?feed=rss2&amp;p=2908</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>A few links for the end of the week</title>
		<link>http://www.dmncommunications.com/weblog/?p=2914</link>
		<comments>http://www.dmncommunications.com/weblog/?p=2914#comments</comments>
		<pubDate>Fri, 17 Feb 2012 13:00:17 +0000</pubDate>
		<dc:creator>Scott Nesbitt</dc:creator>
				<category><![CDATA[links]]></category>

		<guid isPermaLink="false">http://www.dmncommunications.com/weblog/?p=2914</guid>
		<description><![CDATA[Consistency in terminology is crucial Improving knowledge retention in elearning Kai Weber on meeting DITA half way Are docs a responsibility or a business asset? Do breadcrumbs improve usability?]]></description>
			<content:encoded><![CDATA[<div class="tweetmeme_button" style="float: right; margin-left: 10px;">
			<a href="http://api.tweetmeme.com/share?url=http%3A%2F%2Fwww.dmncommunications.com%2Fweblog%2F%3Fp%3D2914"><br />
				<img src="http://api.tweetmeme.com/imagebutton.gif?url=http%3A%2F%2Fwww.dmncommunications.com%2Fweblog%2F%3Fp%3D2914&amp;source=dmnguys&amp;style=compact&amp;service=bit.ly&amp;service_api=R_6b2d5379b04edb8e4ce172df33b67539&amp;b=2" height="61" width="50" /><br />
			</a>
		</div>
<ul>
<li><a href="http://cybertext.wordpress.com/2012/02/09/consistency-pick-one-stick-with-it/">Consistency</a> in terminology is crucial</li>
<li>Improving <a href="http://contentevangelists.wordpress.com/2012/01/19/improving-knowledge-retention-in-elearning/">knowledge retention</a> in elearning</li>
<li>Kai Weber on <a href="http://kaiweber.wordpress.com/2012/02/06/meeting-dita-half-way/">meeting DITA half way</a></li>
<li>Are docs a <a href="http://everypageispageone.com/2012/01/09/are-docs-a-responsibility-or-a-business-asset/">responsibility or a business asset</a>?</li>
<li>Do breadcrumbs <a href="http://www.atlanticbt.com/blog/do-breadcrumbs-improve-usability/">improve usability</a>?</li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://www.dmncommunications.com/weblog/?feed=rss2&amp;p=2914</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>A look at The Little Guide to Un-Procrastination</title>
		<link>http://www.dmncommunications.com/weblog/?p=2899</link>
		<comments>http://www.dmncommunications.com/weblog/?p=2899#comments</comments>
		<pubDate>Mon, 13 Feb 2012 13:00:39 +0000</pubDate>
		<dc:creator>Scott Nesbitt</dc:creator>
				<category><![CDATA[books]]></category>

		<guid isPermaLink="false">http://www.dmncommunications.com/weblog/?p=2899</guid>
		<description><![CDATA[Technical communicators, like anyone else sometimes succumb to procrastination. Well, more than sometimes and sometimes more than most people. Procrastination can take any number of forms. It could be a mindless distraction that eats up work time. Or it could &#8230; <a href="http://www.dmncommunications.com/weblog/?p=2899">Continue reading <span class="meta-nav">&#8594;</span></a>]]></description>
			<content:encoded><![CDATA[<div class="tweetmeme_button" style="float: right; margin-left: 10px;">
			<a href="http://api.tweetmeme.com/share?url=http%3A%2F%2Fwww.dmncommunications.com%2Fweblog%2F%3Fp%3D2899"><br />
				<img src="http://api.tweetmeme.com/imagebutton.gif?url=http%3A%2F%2Fwww.dmncommunications.com%2Fweblog%2F%3Fp%3D2899&amp;source=dmnguys&amp;style=compact&amp;service=bit.ly&amp;service_api=R_6b2d5379b04edb8e4ce172df33b67539&amp;b=2" height="61" width="50" /><br />
			</a>
		</div>
<p><img class="alignleft size-full wp-image-2900" title="Don't do today what you can put off until tomorrow" src="http://www.dmncommunications.com/weblog/wp-content/uploads/2012/02/procrastinate.jpg" alt="Don't do today what you can put off until tomorrow" width="160" height="106" align="left" /> Technical communicators, like anyone else sometimes succumb to procrastination. Well, more than sometimes and sometimes more than most people.</p>
<p>Procrastination can take any number of forms. It could be a mindless distraction that eats up work time. Or it could be a crippling inability to write. Whatever that form it, it takes us away from what we really should be doing.</p>
<p>I&#8217;m speaking from experience. Like many others in this wacky profession, I sometimes prefer to <em>have written</em>. But to get to that point, I need to do the work. And that&#8217;s where procrastination rears its ugly head.</p>
<p>I&#8217;ve been a procrastinator, of varying degrees, as long as I can remember. I&#8217;m not as bad as some, but I have my moments. I&#8217;ve never missed a deadline, but there have been more than a few occasions when I&#8217;ve had to rush to complete assignments that I&#8217;ve left to the 10th or 11th hour.</p>
<p>Which is a why I recommend (and sometimes re-read) Leo Babauta&#8217;s <em><a href="http://zenhabits.net/un-procrastinate/">The Little Guide to Un-Procrastination</a></em>. Being a reader of <a href="http://zenhabits.net">Babauta&#8217;s</a> <a href="http://mnmlist.com">blogs</a> and having read a few of his books, I happily recommend people dip into their PayPal accounts and get a copy of <em>The Little Guide to Un-Procrastination</em>. It&#8217;s money well spent.</p>
<p><span id="more-2899"></span></p>
<h3>Breaking the cycle</h3>
<p>In 67 pages, Babauta offers a lot of advice (much of it from his own experience) on how to beat procrastination. If you&#8217;ve read his other books &#8212; like <em>The Power of Less</em> and <em>Focus</em> &#8212; then much of what&#8217;s in <em>The Little Guide to Un-Procrastination</em> will be familiar. Babauta admits that himself. But there&#8217;s enough new material in this book to keep you engaged and to teach you something.</p>
<p>Essentially, procrastination is a habit. And to break it Babauta counsels you to replace that habit with a new one. You need to do that in small steps, though. Start by focusing on what you need to do for 10 minutes, then reward yourself by taking a short break. Gradually build up from there until you can effortlessly work continuously for an hour or more. It&#8217;s a slow process, but it works.</p>
<p>A bit part of it is breaking the <a href="http://en.wikipedia.org/wiki/Positive_feedback">positive feedback loop</a> that exists when procrastinating. Think about how you feel when, say, you check your email or view a video online or watch TV or read a post on your favourite blog. You need to replace that with the good feeling you get when you write 500 well-strung-together words. As I said in the previous paragraph, you need to do this gradually. The <a href="http://en.wikipedia.org/wiki/Cold_turkey">cold turkey</a> approach rarely works.</p>
<h3>Points of interest</h3>
<p>There are several in the book. The ones that really jumped out at me were, strangely enough, towards the end of the book. They include the chapters on:</p>
<ul>
<li><strong>Killing choice</strong>, which advises you to focus on one thing at a time and finish it before moving on.</li>
<li><strong>Additional procrastination remedies</strong>, which lists eight other things you can try to break the cycle.</li>
<li><strong>Answers to procrastination questions</strong>, which looks at some questions that some of Babauta&#8217;s readers have asked, and his detailed answers.</li>
</ul>
<p>Pointing out those chapters isn&#8217;t meant to diminish the rest of <em>The Little Guide to Un-Procrastination</em>. For me, those chapters contained the bulk of the new, useful information in the book.</p>
<h3>Complaints?</h3>
<p>Only one, and it&#8217;s somewhat minor. Some of the advice that Babauta gives in this book (and others) seems a bit <a href="http://www.phrases.org.uk/meanings/282700.html">pie in the sky</a>. Mainly, the emphasis on the need to focus on work that&#8217;s important to <em>you</em>. I have nothing against the concept, but as a freelancer I don&#8217;t always have the luxury of doing that. I often need to take on work that pays the bills, and which might not be as interesting or important or engaging as I&#8217;d like. Those often suck time and energy away from the projects that I do find important.</p>
<p>Doing this can be harder for full time employees. It&#8217;s not always easy or even possible to negotiate with managers, or to find a job where you can do the type of work that you find important or challenging. I&#8217;m not saying that it can&#8217;t be done, but it&#8217;s not exactly easy.</p>
<h3>Overall thoughts</h3>
<p><em>The Little Guide to Un-Procrastination</em> is a solid book, filled with good advice for technical communicatos (and others). Babauta&#8217;s writing style is simple, but his passion emanates from each page. It&#8217;s a quick read, but packs a lot into a small space.</p>
<p>This book can help you break the cycle of procrastination or, at least, interrupt that cycle. But the key is <em>you</em>. You must want to break the cycle, and be willing to put in the effort. If you are, you probably can&#8217;t find a better guidebook than this one.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.dmncommunications.com/weblog/?feed=rss2&amp;p=2899</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
	</channel>
</rss><!-- Dynamic Page Served (once) in 0.671 seconds -->

