<?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; Alan Porter</title>
	<atom:link href="http://idratherbewriting.com/tag/alan-porter/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>Minimalistic Callouts Heighten Visual Appeal</title>
		<link>http://idratherbewriting.com/2011/01/17/minimalistic-callouts-heighten-visual-appeal/</link>
		<comments>http://idratherbewriting.com/2011/01/17/minimalistic-callouts-heighten-visual-appeal/#comments</comments>
		<pubDate>Mon, 17 Jan 2011 19:29:03 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[blog]]></category>
		<category><![CDATA[Alan Porter]]></category>
		<category><![CDATA[callouts]]></category>
		<category><![CDATA[don moyer]]></category>
		<category><![CDATA[edward tufte]]></category>
		<category><![CDATA[geoff hart]]></category>
		<category><![CDATA[Intercom]]></category>
		<category><![CDATA[visual design]]></category>

		<guid isPermaLink="false">http://idratherbewriting.com/?p=8494</guid>
		<description><![CDATA[Lately I&#8217;ve been working on quick reference guides that contain a lot of callouts around screenshots. (By callouts, I mean explanatory text that points to some part of the image.) In trying to come up with the right design for callouts, I surveyed how other authors approached callouts. Below is a sampling of about 14 different approaches to callouts, with my analysis below each example. ... <a href="http://idratherbewriting.com/2011/01/17/minimalistic-callouts-heighten-visual-appeal/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<p>Lately I&#8217;ve been working on quick reference guides that contain a lot of callouts around screenshots. (By callouts, I mean explanatory text that points to some part of the image.) In trying to come up with the right design for callouts, I surveyed how other authors approached callouts. Below is a sampling of about 14 different approaches to callouts, with my analysis below each example.</p>
<h3>Some Examples of Callouts</h3>
<div id="attachment_8495" class="wp-caption alignnone" style="width: 610px"><a href="http://www.yasda.com/ymc325.php"><img class="size-medium wp-image-8495" title="Callout example 1" src="http://idratherbewriting.com/wp-content/uploads/2011/01/1-600x364.png" alt="Callout example 1" width="600" height="364" /></a><p class="wp-caption-text">Callout example 1</p></div>
<p>The author avoids bubbles around the callouts and keeps the text minimalistic. Each callout has a bold title followed by regular text. Callout lines end with a filled circle rather than an arrow. This works well. I&#8217;m not sure why the author stacked all the callouts on one side of the image, except perhaps to save space.</p>
<div id="attachment_8496" class="wp-caption alignnone" style="width: 554px"><a href="http://www.aboutplcs.com/P3000/features/portsportsports.html?sidebar=overviewtree&amp;menuitem=302&amp;top=1&amp;"><img class="size-full wp-image-8496" title="Callout example 2" src="http://idratherbewriting.com/wp-content/uploads/2011/01/2.png" alt="Callout example 2" width="544" height="588" /></a><p class="wp-caption-text">Callout example 2</p></div>
<p>The inclusion of callout bubbles around the text makes the graphic look too busy. The callout bubble format takes the visual emphasis off the device and places it onto the callouts themselves. Callouts should be more in the visual background, not the foreground.  The writer also uses triangles formed from the callouts themselves to function as arrows. This increases the amount of visual attention placed on the callout format. With so many callouts, the callout bubble format looks clunky and cluttered.</p>
<div id="attachment_8497" class="wp-caption alignnone" style="width: 543px"><a href="http://www.mgraves.org/2010/03/review-polycom-vvx-1500-business-media-phone/"><img class="size-full wp-image-8497" title="Callout example 3" src="http://idratherbewriting.com/wp-content/uploads/2011/01/3.png" alt="Callout example 3" width="533" height="334" /></a><p class="wp-caption-text">Callout example 3</p></div>
<p>Again, boxes around the callouts draw too much visual attention to the callouts themselves. This visual attention competes with the image. The lines of the callout boxes combine with the yellow connecting lines to create a sense of busyness and clutter.</p>
<div id="attachment_8498" class="wp-caption alignnone" style="width: 610px"><a href="http://insulation.owenscorning.ca/homeowners/insulation-products/"><img class="size-medium wp-image-8498" title="Callout example 4" src="http://idratherbewriting.com/wp-content/uploads/2011/01/4-600x512.png" alt="Callout example 4" width="600" height="512" /></a><p class="wp-caption-text">Callout example 4</p></div>
<p>Besides the obviously wrong choice of a pink font, which blends too easily in with the pink color of the house and hurts the eyes, the text is fairly minimalistic. The author here avoids arrows on callout lines as well to reduce the visual energy. The author also uses the space around the graphic rather than stacking all callouts on top of each other on one side. This works, but the loud pink font still calls too much attention to the text. A softer, quieter black font would have done a better job at minimizing the massive amount of text around this graphic. The soft gray color of the callout lines is a good choice. If the author had used pink callout lines in addition to pink text, it would have been a nightmare.</p>
<div id="attachment_8499" class="wp-caption alignnone" style="width: 607px"><a href="http://macgroup.infopop.cc/eve/forums/a/tpc/f/4646075902/m/3551064471"><img class="size-full wp-image-8499" title="Callout example 5" src="http://idratherbewriting.com/wp-content/uploads/2011/01/5.png" alt="Callout example 5" width="597" height="535" /></a><p class="wp-caption-text">Callout example 5</p></div>
<p>Callouts are short names only here. Given the abundance of callouts, the author wisely chose a minimalistic style for the callouts, with simple callout lines that avoid even circles or arrows. The problem with this graphic is that we have no descriptions of any components, so names such as &#8220;Rotary Encoder buttons&#8221; are meaningless. The author needs to take a less comprehensive approach to describing the image. Or else the author needs to provide a reference to more information in some of the callouts.</p>
<div id="attachment_8500" class="wp-caption alignnone" style="width: 485px"><a href="http://www.tigerdirect.com/applications/SearchTools/item-details.asp?EdpNo=4245188"><img class="size-full wp-image-8500" title="Callout example 6" src="http://idratherbewriting.com/wp-content/uploads/2011/01/6.png" alt="Callout example 6" width="475" height="671" /></a><p class="wp-caption-text">Callout example 6</p></div>
<p>The author&#8217;s use of referential numbers will be useful for translation of this content. Geoff Hart makes this point in <a href="http://intercom.stc.org/2011/01/integrating-text-with-graphics-in-procedures-3/">Integrating Text with Graphics in Procedures</a> (Dec 2010 Intercom), but also notes that the text loses much of its power by separating itself from the visual element it describes. Geoff writes:</p>
<blockquote><p>The primary disadvantage is that this approach separates the symbol (the number beside part of the image) from its meaning&#8230;. That increases the cognitive difficulty of using the graphic because readers must lead the task at hand (examining the graphic) to perform a secondary task (finding a number in the key to read its explanation), then must return to the image so they can ponder the relevance of that explanation.</p></blockquote>
<p>Geoff says that as long as you don&#8217;t have to keep moving back and forth between the graphic and the explanation, this format can work all right. In these cases, the graphic would serve a referential purpose, where you need only one or two pieces of information.</p>
<div id="attachment_8501" class="wp-caption alignnone" style="width: 610px"><a href="http://thepactwiki.wikispaces.com/T%26D+Organization+%26+Systems+%26+Processes+Management"><img class="size-medium wp-image-8501" title="Callout example 7" src="http://idratherbewriting.com/wp-content/uploads/2011/01/7-600x443.png" alt="Callout example 7" width="600" height="443" /></a><p class="wp-caption-text">Callout example 7</p></div>
<p>Clearly at some point you enter a state in which a graphic has too much text. The author should reduce the number of callouts as well as drop the borders around the callouts, which only increase their size and visual attention.</p>
<div id="attachment_8502" class="wp-caption alignnone" style="width: 593px"><a href="http://www.monstercable.com/productdisplay.asp?pin=3849&amp;loadT=10"><img class="size-full wp-image-8502" title="Callout example 8" src="http://idratherbewriting.com/wp-content/uploads/2011/01/8.png" alt="Callout example 8" width="583" height="551" /></a><p class="wp-caption-text">Callout example 8</p></div>
<p>The callout lines here are right angles, similar to what you might draw in Visio, with no rounded corners or arrows. While these square connectors may reduce the visual energy by giving the reader symmetry, the lines are a little hard to follow. This convention more closely aligns network diagrams and an older graphics style. The author could probably round the corners to modernize the look, or use straight lines with a soft color that doesn&#8217;t draw too much attention when crossing the image.</p>
<div id="attachment_8503" class="wp-caption alignnone" style="width: 494px"><a href="http://www.bestvacuum.com/nss-pacer-214.html"><img class="size-full wp-image-8503" title="Callout example 9" src="http://idratherbewriting.com/wp-content/uploads/2011/01/9.png" alt="Callout example 9" width="484" height="423" /></a><p class="wp-caption-text">Callout example 9</p></div>
<p>With this graphic, the reader has to make the connection between the numbers and the callout. No callout lines connect the two at all, which increases the cognitive load to interpret the graphic. The double instances of the numbers amplifies the perceived amount of notes and callouts on this relatively simple graphic.</p>
<div id="attachment_8504" class="wp-caption alignnone" style="width: 461px"><a href="http://www.aprocessgroup.com/products/product_02_010402.asp"><img class="size-full wp-image-8504" title="Callout example 10" src="http://idratherbewriting.com/wp-content/uploads/2011/01/10.png" alt="Callout example 10" width="451" height="437" /></a><p class="wp-caption-text">Callout example 10</p></div>
<p>Notice how these big blue callout formats amplify the presence of the text. The arrowheads make the callout lines look less elegant. The various slants of the callouts produce more visual busyness and gives the graphic an amateur look.</p>
<div id="attachment_8505" class="wp-caption alignnone" style="width: 485px"><a href="http://www.gx2003.com/"><img class="size-full wp-image-8505" title="Callout example 11" src="http://idratherbewriting.com/wp-content/uploads/2011/01/11.png" alt="Callout example 11" width="475" height="468" /></a><p class="wp-caption-text">Callout example 11</p></div>
<p>The author uses yellow callout lines with black callout text. This contrast is an interesting choice. Would gray not have worked here? Against a white backdrop, the yellow lines fade out and are hard to see, so there&#8217;s a visual strain in trying to connect the callouts to the areas they point to.</p>
<div id="attachment_8506" class="wp-caption alignnone" style="width: 543px"><a href="http://www.advancedbionics.com/Products/Components_of_a_Cochlear_Implant/index.cfm?langid=1"><img class="size-full wp-image-8506" title="Callout example 12" src="http://idratherbewriting.com/wp-content/uploads/2011/01/12.png" alt="Callout example 12" width="533" height="424" /></a><p class="wp-caption-text">Callout example 12</p></div>
<p>The callouts here are minimalistic and professional looking. Notice how the reduction in callout formatting increases the professionalism and clarity? The author also chooses a soft gray rather than a hard black for each callout line and end point &#8212; this helps reduce the focus on the callouts and places more visual attention on the image. The callout supports the image rather than dominating the image.</p>
<p>This minimalistic approach echoes a point <a href="http://thecontentpool.com/">Alan Porter</a> makes in the last STC <em>Intercom</em>. Porter quotes one of Edward Tufte&#8217;s definitions of graphic excellence:</p>
<blockquote><p>Graphical excellence is that which gives the viewer the greatest number of ideas in the shortest time with the least ink in the smallest space. (<a href="http://intercom.stc.org/2011/01/the-global-language-using-symbols-and-icons-when-delivering-technical-content/">The Global Language: Using symbols and icons when Delivering Technical Content</a>, Dec 2010 <em>Intercom</em>.)</p></blockquote>
<p>In other words, Tufte calls for a minimalism with graphics &#8212; express the idea in the fewest strokes, with the least ink. Leave out the noise. Jean Luc Doumont recommends the same graphic minimalism in his book <a href="http://idratherbewriting.com/2009/06/25/page-layout-and-design-tips-from-jean-luc-doumonts-trees-maps-and-theorems/">Trees, maps, and theorems</a>. In “Achieving simplicity and harmony” (p.75), Jean Luc argues that with formatting, writers should use “a healthy dose of self-restraint” instead of indulging in the many layout possibilities that desktop publishing software offers.</p>
<div id="attachment_8507" class="wp-caption alignnone" style="width: 370px"><a href="http://www.shelbyinc.com/Default.aspx?Sec=Products&amp;FamilyID=5&amp;Page=ProductTemplate&amp;ProductID=80"><img class="size-full wp-image-8507" title="Callout example 13" src="http://idratherbewriting.com/wp-content/uploads/2011/01/13.png" alt="Callout example 13" width="360" height="420" /></a><p class="wp-caption-text">Callout example 13</p></div>
<p>Here the author uses rounded callout lines rather than the square connectors. The rounded/bent nature of the arrows produces more of a sense of motion. Notice how the &#8220;Cable clearance&#8221; callout has a different callout style &#8212; pinkish dotted lines, rather than blue? Presumably this is because the callout lines intersect other callout lines, and the author wants to avoid this collision, which produces visual cacophony. However, the different color of the callout lines here suggests that the &#8220;Cable clearance&#8221; callout is in a different category or class than the other callout lines. There&#8217;s a semantic problem with changing callout line formats.</p>
<div id="attachment_8508" class="wp-caption alignnone" style="width: 442px"><a href="https://www.halosleep.com/hospitals/in_hospital_program/"><img class="size-full wp-image-8508" title="Callout example 14" src="http://idratherbewriting.com/wp-content/uploads/2011/01/15.png" alt="Callout example 14" width="432" height="422" /></a><p class="wp-caption-text">Callout example 14</p></div>
<p>This is my favorite callout example. Despite the abundance of callout text, the text doesn&#8217;t dominate the rather small image. The callout headings are minimal and in a narrow font to reduce visual space. The callout lines &#8212; light black &#8212; are as minimal as they can be, and lack even a dot or arrow at the end.</p>
<p>Although graphics programs offer a lot of opportunities with callout design, many times the design only detracts from the intent of the callouts. Don Moyer explains that the focus on design can sometimes backfire:</p>
<blockquote><p>sometimes so much effort goes into aesthetics, special effects, fancy shadows, glowing objects, and 3D wizardry that the scope and structure of the story is neglected. (<a href="http://intercom.stc.org/2011/01/the-trouble-with-visual-explanations-a-quick-look-at-common-problems/">The Trouble with Visual Explanations: A Quick Look at Common Problems</a>, Dec 2010 Intercom)</p></blockquote>
<p>In other words, the &#8220;professional&#8221; execution of graphics can sometimes overshadow or even  divert attention from the image&#8217;s central meaning. This last example reinforces the strength of minimalism when it comes to callouts. Le</p>
<h3>Conclusions</h3>
<p>Callouts should not distract the focus away from the image but should supplement the image. To keep the callouts in the visual background, make the callouts as minimal as possible, avoiding callout bubbles, box formatting, or background shading. These design-heavy types of callout formats work if you&#8217;re trying to &#8220;call out&#8221; attention to the presence of the callout text, or if you have just one or two callouts. But when you have an abundance of callout text on a graphic, as we often do in technical illustrations, shouting attention to each callout foregrounds the callouts at the expense of the graphic and leads to a clutterered, busy, amateur look. Each callout screams, &#8220;Look at me!,&#8221; and when you have 6 to 8 callouts on a single image, the effect is too much noise.</p>
<p>When it comes to callout lines, avoid arrows at the end or any other graphics that draw too much attention to the line. Especially if the lines will be slanted in various directions, keep the width narrow to avoid drawing too much attention to conflicting slants (which produce negative visual energy). Choose a soft color, such as light black or gray, to reduce attention on the lines. Keeping with the minimalistic technique, maintain an adequate padding of white space between each callout.<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/2011/01/17/minimalistic-callouts-heighten-visual-appeal/feed/</wfw:commentRss>
		<slash:comments>9</slash:comments>
	
		<series:name><![CDATA[Visual Imagination]]></series:name>
	</item>
		<item>
		<title>Review of Alan Porter&#8217;s Wiki: Grow Your Own for Fun and Profit</title>
		<link>http://idratherbewriting.com/2010/11/25/review-of-alan-porters-wiki-grow-your-own-for-fun-and-profit/</link>
		<comments>http://idratherbewriting.com/2010/11/25/review-of-alan-porters-wiki-grow-your-own-for-fun-and-profit/#comments</comments>
		<pubDate>Thu, 25 Nov 2010 15:25:40 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[blog]]></category>
		<category><![CDATA[Alan Porter]]></category>
		<category><![CDATA[book reviews]]></category>
		<category><![CDATA[collaborative authoring]]></category>
		<category><![CDATA[Technical Writing]]></category>
		<category><![CDATA[WebWorks]]></category>
		<category><![CDATA[Wikis]]></category>
		<category><![CDATA[WritersUA]]></category>

		<guid isPermaLink="false">http://idratherbewriting.com/?p=8181</guid>
		<description><![CDATA[Alan Porter&#8217;s Wiki: Grow Your Own for Fun and Profit, published by XML Press in October 2010, provides an excellent introduction to wikis. This is a short, easy-to-read book spanning about 150 pages. Alan has a keen sense of organization and liveliness in his writing. He carries the gardening metaphor throughout the book, ending with five solid case studies and an extended response to common ... <a href="http://idratherbewriting.com/2010/11/25/review-of-alan-porters-wiki-grow-your-own-for-fun-and-profit/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<div id="attachment_8210" class="wp-caption alignright" style="width: 165px"><a href="http://xmlpress.net/publications/wiki-how-to-grow/"><img class="size-full wp-image-8210 " title="Wiki: Grow your Own for Fun and Profit, by Alan Porter" src="http://idratherbewriting.com/wp-content/uploads/2010/11/wikiporter.png" alt="Wiki: Grow your Own for Fun and Profit, by Alan Porter" width="155" height="237" /></a><p class="wp-caption-text">Wiki: Grow your Own for Fun and Profit, by Alan Porter</p></div>
<p>Alan Porter&#8217;s <em>Wiki: Grow Your Own for Fun and Profit</em>, <a href="http://xmlpress.net/2010/10/13/wiki-grow-your-own-for-fun-and-profit/">published by XML Press</a> in October 2010, provides an excellent introduction to wikis. This is a short, easy-to-read book spanning about 150 pages. Alan has a keen sense of organization and liveliness in his writing. He carries the gardening metaphor throughout the book, ending with five solid case studies and an extended response to common criticisms against wikis.</p>
<p>Sometimes discussions about wikis make it seem as if they&#8217;re a new technology. But Alan explains that Ward Cunningham developed the first wiki in 1995 &#8212; fifteen years ago! Despite the relative ease with which Alan responds to wiki concerns (about inaccuracies, lack of participation, disorganization, and so on), wikis still haven&#8217;t gained traction as the predominant authoring platform.</p>
<p>One has to wonder, given the many advantages of wikis, why they haven&#8217;t they taken off as <em>the </em>platform for web and help content? Especially in an age of collaborative authoring, distributed ownership, dynamic editing, and agile development, you&#8217;d think wikis would be the most common platform for help authoring in tech comm departments.</p>
<p>And yet, in the <a href="http://www.surveymonkey.com/s/tools_survey">2010 WritersUA Tools Survey</a>, wikis aren&#8217;t even included as a tool (see the <a href="http://idratherbewriting.com/wp-content/uploads/2010/11/writersuatoolssurvey.png">survey&#8217;s list of tools</a>). Almost every other help authoring, graphics, and video, and layout tool is mentioned, but wikis are absent. Either WritersUA accidentally omitted them (this year and every previous year), or they don&#8217;t take wikis seriously, or wikis aren&#8217;t considered help authoring tools.</p>
<p>My point is that wikis still have a long way to go toward mainstream adoption, despite their decade-and-a-half presence on the web. Alan&#8217;s book is a welcome addition to the promotion of wikis and wiki culture.</p>
<p>Although Alan&#8217;s audience seems more focused on new wiki users, he does dive into an issue that I struggle with: wiki round tripping. With round tripping, you publish from a source format to a wiki format, allow the wiki to be updated, and then write your updated wiki content back to your source format. For example, with WebWorks, Alan says the original documentation source is in Framemaker, which they publish to a wiki format using ePublisher. If they did round-tripping, after the wiki was updated, they would write the updated wiki content back to Framemaker.</p>
<p>However, WebWorks doesn&#8217;t do round tripping. After users make edits to the WebWorks documentation, the WebWorks team manually updates the source Framemaker files with the changed content.</p>
<p>Even if they wanted to do round-tripping, it isn&#8217;t easy to achieve technically. And I assume the technical solution isn&#8217;t available because apparently there isn&#8217;t a business case for it.  Alan says,</p>
<blockquote><p>When I hear people using the phrase &#8217;round-tripping&#8217; they tend to be talking in terms of automating the process. When I have asked people what the business case is for implementing automated round-tripping, very few have an answer beyond &#8220;well it would be cool.</p></blockquote>
<p>Alan notes that with a multilingual wiki, there may be a valid business case. But for most corporate content, round-tripping may pose liability or legal issues, and requires human intervention to evaluate whether the updated wiki content should change the source file. If round tripping is necessary, Alan recommends making the wiki the original source.</p>
<p>This section was most relevant to me for several reasons. First, round-tripping is very much a tech comm topic rather than a general wiki topic. Second, Alan gets into a difficult issue and explores it in depth. And third, there is no easy answer.</p>
<p>In the authoring process for some of my projects, we do keep the wiki as the original source, rather than maintaining a separate source of content. We all collaborate through the wiki, building the documentation as we go. In my opinion, working in Framemaker and then publishing to the wiki (the WebWorks model) undercuts the collaborative nature and power of wikis. If you&#8217;re the only one creating the documentation, it might make sense. But in a collaborative authoring model, with a team of internal and external authors, why create documentation in Framemaker first and then publish it to the wiki? How exactly would you share the content? Also, if community momentum picks up, how can you feasibly input the community&#8217;s constant updates back into the source files?</p>
<p>However, if you do use a wiki as the original source, you run into a problem: how do you selectively package up the wiki content and output its content into printable formats? How do you personalize the topics based on specific roles?</p>
<p>These latter questions might be related more to the wiki tool rather than wikis in general. Some wikis allow you to bundle the content together as a PDF output, while other platforms require extensions and hacks to achieve this. Access control also varies widely among wikis. Confluence offers different access control levels, while Mediawiki has an everything-open or everything-closed policy.</p>
<p>Alan&#8217;s book makes me reflect more about wikis. Will they ever take off? What holds them back? Is it the lack of a universal wiki syntax? Is it because wikis all too often devolve into chaos? Is it because the fundamental idea of volunteer group writing is flawed? I&#8217;m not sure. I prefer wikis more than traditional help authoring tools, but wikis still pose many challenges. I&#8217;m glad Alan took the time to write a book on wikis. It will help push tech comm authoring models more toward wikis.</p>
<p>For a sample chapter and links to buy <em>Wiki: Grow Your Own for Fun and Profit</em>, see the <a href="http://xmlpress.net/publications/wiki-how-to-grow/">XML Press site book page</a>. To read Alan Porter&#8217;s blog, <em>The Content Pool</em>, go to <a href="http://4jsgroup.blogspot.com/">http://4jsgroup.blogspot.com</a>.<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/11/25/review-of-alan-porters-wiki-grow-your-own-for-fun-and-profit/feed/</wfw:commentRss>
		<slash:comments>7</slash:comments>
		</item>
		<item>
		<title>Reinventing Yourself Through Your Blog</title>
		<link>http://idratherbewriting.com/2009/11/01/reinventing-yourself-through-your-blog/</link>
		<comments>http://idratherbewriting.com/2009/11/01/reinventing-yourself-through-your-blog/#comments</comments>
		<pubDate>Mon, 02 Nov 2009 04:10:21 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[blog]]></category>
		<category><![CDATA[Alan Porter]]></category>
		<category><![CDATA[Anne Gentle]]></category>
		<category><![CDATA[Blogging]]></category>
		<category><![CDATA[branding]]></category>
		<category><![CDATA[identity]]></category>
		<category><![CDATA[reinventing the self]]></category>
		<category><![CDATA[richard hamilton]]></category>
		<category><![CDATA[tedopres]]></category>
		<category><![CDATA[WebWorks]]></category>
		<category><![CDATA[xml press]]></category>

		<guid isPermaLink="false">http://www.idratherbewriting.com/?p=4947</guid>
		<description><![CDATA[The other week, while I was at the WebWorks Roundup conference in Texas, where I was one of the featured industry speakers, I was sitting next to Anne Gentle during one of the panel sessions, and I asked her about branding. It seems like once you become branded through your blog, it’s hard to reinvent yourself. I was speaking at WebWorks on blogging and web ... <a href="http://idratherbewriting.com/2009/11/01/reinventing-yourself-through-your-blog/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<p>The other week, while I was at the <a href="http://www.webworksroundup.com/" target="_blank">WebWorks Roundup</a> conference in Texas, where I was one of the featured industry speakers, I was sitting next to <a href="http://justwriteclick.com" target="_blank">Anne Gentle</a> during one of the panel sessions, and I asked her about branding. It seems like once you become branded through your blog, it’s hard to reinvent yourself.<br />
<span id="more-4947"></span><br />
I was speaking at WebWorks on blogging and web 2.0. More than anything else, my blog has branded me as <em>a blogger</em>. This brand has led to numerous speaking invitations at conferences and chapters. The more I speak about blogging, the more I become branded as a blogging expert –- it’s a cycle of branding that perpetuates itself.</p>
<p>At the conference, I learned that although some people have branded themselves online in certain ways, they can be much different in person. For example, online you know Richard Hamilton, founder of <a href="http://xmlpress.net" target="_blank">XML Press</a>, as an entrepreneurial publisher focusing on the technical communication market. You may also see Richard as an experienced manager through his recent book <a href="http://xmlpress.net/publications/managing-writers/" target="_blank"><em>Managing Writers</em></a>. And you may gather that Richard is a careful, analytical thinker from his <a href="http://rlhamilton.wordpress.com/" target="_blank">lengthy conference write-up posts</a>. That’s how Richard has branded himself &#8212; as a publisher and manager.</p>
<p>But Richard has another side to him as well. He’s a pilot and previously owned his own airplane. He loves reading literature, especially mysteries. For example, he has read Sue Grafton’s mystery series (<em>A is for Alibi, B is for </em>…) series up to G. His whole face lights up when he starts talking about mystery novels with another mystery aficionado.</p>
<p>He boots his computer in Ubuntu and prefers to write everything in DocBook XML. He also seems to enjoy long car drives (for example, he drove from Colorado to Texas and back for the conference). More than anything, Richard is one of the most warm, friendly, and conversational people you will ever meet.</p>
<p>Alan Porter is even more of an interesting figure when it comes to branding. Online you know Alan as the head of <a href="http://webworks.com" target="_blank">WebWorks</a> (or VP of Operations). You read <a href="http://4jsgroup.blogspot.com" target="_blank">his blog</a> as an expert in the tech comm industry, especially with wikis. His forthcoming book, <a href="http://xmlpress.net/publications/wiki-how-to-grow/" target="_blank"><em>Wikis: Grown Your Own for Fun and Profit</em></a>, will only solidify his wiki branding. He also blogs about trends in user behavior, from observing, for example, the <a href="http://4jsgroup.blogspot.com/2008/12/move-over-dita-chaos-is-coming.html" target="_blank">way his teenage daughter approaches her homework</a>.</p>
<p>But in person, you’ll find that, like Richard, Alan has <a href="http://alanjporter.com/" target="_blank">another side to him</a> entirely. A cowboy-boot wearing Englishman, Alan is an avid comic artist. Mention conferences like Comicon and Dragicon and his ears perk up. He regularly writes the stories, dialog, and scripts for the comic book <em>CARS</em>.</p>
<p>In addition to his drawing talents, Alan has also written books on James Bond, Batman, Star Trek, and the Beatles. He has strong feelings about the importance of storytelling. In fact, Alan works only 30 hours a week so he can focus on his writing.</p>
<p>Alan has written a mystery novel set with NASCAR racing and another novel about Shakespeare pretending to be Christopher Marlowe, which an agent of his was shopping around Hollywood for a possible movie. Alan is also a consultant for <a href="http://www.tedopres.com/" target="_blank">Tedopres</a>, a company focused on simplified technical English. He can fly out to your location and train your employees on simplified technical English techniques.</p>
<p>Alan understands the importance of recording presentations. He <a href="http://www.webworks.com/Community/RoundUp_Conference/2008/Presentations/General_Sessions.shtml" target="_blank">records all major WebWorks conference</a> sessions, making them available at first on a limited basis and then eventually opens them up to everyone. He’s allergic to gluten, is married to a court reporter, and when you mention his competitor’s products, such as Flare, he breathes a deep sigh.</p>
<p>I’ve gotta say, Alan is one of the most interesting people to meet, because unless you know this other side of Alan, all of this comes as a complete surprise. It’s a surprise mostly because Alan has chosen not to brand himself this way online. In fact, he has a policy that he will not write about either his company’s products or his competitor’s products on his blog.</p>
<p>Blogs provide you with an opportunity to brand yourself with an identity you want to be known by. But you have to be careful what you blog about, because that brand then stays with you. You become known for that brand, and it can be hard to change.</p>
<p>Reinventing yourself with a new identity isn’t impossible. It just requires you to shift your focus, to start writing about a new topic.</p>
<p>I mentioned at the beginning that I’m not so eager to be branded as a blogger (and podcaster and WordPress person). Ideally, I would like to be a screencaster and wiki expert as well. To make that happen, I’ll have to shift the focus of my blog &#8212; for about the next 200 posts.</p>
<p>I could make the shift, but I think I prefer to let things happen in a more natural way. It’s more interesting to let water flow in the direction it wants to. And then every once in a while look up to see where you are.<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/2009/11/01/reinventing-yourself-through-your-blog/feed/</wfw:commentRss>
		<slash:comments>8</slash:comments>
		</item>
		<item>
		<title>Seven Deadly Sins of Blogging: #1 Being Fake</title>
		<link>http://idratherbewriting.com/2009/09/15/seven-deadly-sins-of-blogging-1-being-fake/</link>
		<comments>http://idratherbewriting.com/2009/09/15/seven-deadly-sins-of-blogging-1-being-fake/#comments</comments>
		<pubDate>Tue, 15 Sep 2009 13:45:41 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[blog]]></category>
		<category><![CDATA[Alan Porter]]></category>
		<category><![CDATA[Blogging]]></category>
		<category><![CDATA[corporate blogging]]></category>
		<category><![CDATA[currency]]></category>
		<category><![CDATA[fake]]></category>
		<category><![CDATA[Kathy Sierra]]></category>
		<category><![CDATA[penelope trunk]]></category>
		<category><![CDATA[personal sharing]]></category>
		<category><![CDATA[real]]></category>
		<category><![CDATA[Sarah O'Keefe]]></category>
		<category><![CDATA[trust]]></category>
		<category><![CDATA[walmart]]></category>

		<guid isPermaLink="false">http://www.idratherbewriting.com/?p=4714</guid>
		<description><![CDATA[I&#8217;ve decided to write a series of posts about what I consider to be the Seven Deadly Sins of Blogging (because sins always seem more interesting than virtues). Basically, I&#8217;m preparing for some presentations on blogging, and I&#8217;m hoping to get some scrutiny and feedback on these ideas. I plan to cover each one of the sins in depth with separate posts over the course ... <a href="http://idratherbewriting.com/2009/09/15/seven-deadly-sins-of-blogging-1-being-fake/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<p>I&#8217;ve decided to write a series of posts about what I consider to be the Seven Deadly Sins of Blogging (because sins always seem more interesting than virtues). Basically, I&#8217;m preparing for some presentations on blogging, and I&#8217;m hoping to get some scrutiny and feedback on these ideas. I plan to cover each one of the sins in depth with separate posts over the course of the next two weeks. My version of the seven deadly sins of blogging are as follows: being fake, <a href="http://www.idratherbewriting.com/2009/10/04/seven-deadly-sins-of-blogging-2-being-irrelevant/">irrelevant</a>, <a href="http://www.idratherbewriting.com/2009/10/13/the-seven-deadly-sins-of-blogging-sin-3-being-boring/" target="_blank">boring</a>, <a href="http://www.idratherbewriting.com/2009/10/17/seven-deadly-sins-of-blogging-sin-4-being-unreadable/">unreadable</a>, <a href="http://www.idratherbewriting.com/2009/10/17/the-seven-deadly-sins-of-blogging-sin-5-being-irresponsible/">irresponsible</a>, <a href="http://www.idratherbewriting.com/2009/10/18/the-seven-sins-of-blogging-sin-6-being-unfindable/">unfindable</a>, and <a href="http://www.idratherbewriting.com/2009/10/31/the-seven-deadly-sins-of-blogging-sin-7-being-inattentive/">inattentive</a>.</p>
<h3>Fake Hurts the Currency of the Blogosphere</h3>
<p>If there&#8217;s one advantage blogs have over other media, such as television, magazines, and even newspapers, it&#8217;s trust, because bloggers aren&#8217;t supposed to be fake. Bloggers are usually independent voices, without financial motives or agendas.  The blogger is somewhat of a free-roaming analyst, at liberty to write about any topic, from any perspective, without any obligation to corporate requirements. With such freedom, the independent blogger automatically has a certain degree of reader trust.</p>
<p>This sense of trust is key to the blog&#8217;s appeal. In a guest post on Problogger, <a href="http://www.problogger.net/archives/2007/01/09/the-rules-behind-creating-a-great-blog/" target="_blank">Tony Hung says</a> trust is &#8220;the only real currency in the blogosophere.&#8221; Hung explains,</p>
<blockquote><p>At the end of the day, trust is the only real currency in the blogosphere, and people who read blogs have the expectation that they’re getting at the truth — in whatever form the truth is to them. And because there is the presumption of truth, readers will often react in an intense fashion to being manipulated, hoodwinked, and otherwise bamboozled.</p></blockquote>
<p>In other words, the strong card that bloggers hold is a sense of trust with readers, which comes from their display of candid honesty. Readers react strongly when they find out a blogger is bamboozling them. For example, a few years ago, Edelman PR created a blog for Wal-Mart called <a href="http://www.businessweek.com/bwdaily/dnflash/content/oct2006/db20061018_445917.htm" target="_blank">Wal-Marting Across America</a> that consisted of a couple supposedly traveling across America in an RV checking out all the Wal-Marts along the way and writing about their experiences. When someone discovered that Wal-Mart was paying their expenses and sponsoring the trip, readers were furious because the blog was fake. <span id="more-4714"></span></p>
<h3>Sharing and Trust</h3>
<p>Not being fake is the first step in getting currency with your blog. To move in the opposite direction of fake, though, you have to share of yourself. It almost seems that the more open and sharing you are, the more powerful your posts become. For example, <a href="http://en.wikipedia.org/wiki/Stephen_Fry" target="_blank">Stephen Fry</a>, a writer, actor, and film director in the UK, recently wrote a semi-confessional post in which he explains how he loathes seeing some of his quotes on book jackets. Apparently <a href="http://www.thebookseller.com/news/96631-story-collection-soars-after-fry-tweet.html" target="_blank">one line of praise from Fry</a> on Twitter alone can dramatically boost book sales, putting the book near the top of Amazon&#8217;s charts.  When Fry tweets, he writes &#8220;completely from the heart,&#8221; <a href="http://www.thebookseller.com/news/96631-story-collection-soars-after-fry-tweet.html" target="_blank">one journalist explains</a>.</p>
<p>You might think that a critic with such literary power would feel nothing but satisfaction and pleasure at helping promote the books he loves. And to a certain extent Fry does. But in this post, Fry also shares another side of his feelings. He jokes with his literary agent that he will make a public confession that he hasn&#8217;t read any of the books for which he supplied quotes:</p>
<blockquote><p>The plan, as I told my agent, was to make this confession as a way of getting publishers off my back. It may sound ungracious, but I get asked so many times a week to read book and supply quotes for them that I’m getting a bit fed up. Not because I don’t like reading, nor because I don’t like being sent books, though mostly of course, I am sent proof copies rather than the finished article. No, what I’m fed up with (and it is my contention that I am SO not alone in this) is seeing my name on the fronts, backs and flaps of books saying things like “a beautifully paced, unforgettable thriller”, “a magnificent feat of imagination”, “a delicately realised and vividly felt journey through memory and desire”, etc etc. Yuckety, yuckety, yuck. Pukety, pukety puke. (&#8220;<a href="http://www.stephenfry.com/2009/09/11/dont-quote-me/" target="_blank">Don&#8217;t Quote Me</a>&#8220;)</p></blockquote>
<p>The more you&#8217;re open, transparent, and sharing on your blog, like in this post from Fry, where he shares his real thoughts, which may be a little surprising or startling to some, <a href="http://weblogtoolscollection.com/archives/2007/01/14/importance-of-transparency-in-blogging/ " target="_blank">the more trust you engender</a> with your readers. We love Fry even more because of this post (and consequently, I&#8217;m guessing he&#8217;ll be in even more demand for book quotes).</p>
<p>For another example of a post that shares personal information with influence, read this mind-blowing post from the always fascinating Penelope Trunk: <a href="http://blog.penelopetrunk.com/2009/07/21/how-to-decide-how-much-to-tell-about-yourself-on-your-blog/" target="_blank">How to Decide How Much to Reveal About Yourself</a>. She shares so much it nearly crosses boundaries, but the effect? Nearly 350 comments on the post from engaged readers.</p>
<h3>Insurmountable Challenges from Corporate Bloggers</h3>
<p>Independent bloggers may find that trust and personal sharing come easy. But corporate bloggers who write about their company&#8217;s products or services have nearly insurmountable challenges when it comes to trust. A corporate blogger struggles against the &#8220;used car salesman situation&#8221;: no matter what the salesman says, you really don&#8217;t trust him. If he praises a car on his lot and recommends that you buy it because it&#8217;s a great deal, uhm, yeah, you don&#8217;t believe that because the salesman&#8217;s agenda is obvious &#8212; he wants to sell you a car. There&#8217;s no trust.</p>
<p>Corporate bloggers have the same problem. As a reader, you may not believe the blogger because of the obvious agenda. But it&#8217;s a damned-if-you-do, damned-if-you-don&#8217;t situation. If corporate bloggers praise their company&#8217;s products or services, we don&#8217;t believe the blogger. If corporate bloggers disparage the products or services, we perhaps believe the blogger, but this may be damaging to the company&#8217;s product or service. And most likely the CEO won&#8217;t allow negativity posts. However you look at it, trust is an issue that permeates corporate blogs.</p>
<p>According to research from <a href="http://blogs.forrester.com/groundswell/2008/12/people-dont-tru.html" target="_blank">Forrester on corporate blogging</a>, Josh Bernoff says that &#8220;only 16% of online consumers who read corporate blogs say they trust them.&#8221; And those same 16% pretty much trust everything. Because of this distrust with corporate bloggers, Josh concludes:</p>
<blockquote><p>If you blog, your goal should be to create a blog about which people say “I like that – I don’t think of it as a company blog.” For the most part, that’s a hurdle you need to jump to gain their trust. I don’t mean to hide who is writing the blog. I mean it has to be more about your customers than it is about you. Blogs exclusively about companies and products are what I think generate these low trust ratings. So don’t do a blog like that.</p></blockquote>
<p>Kathy Sierra also <a href="http://twitter.com/KathySierra/status/1177090435" target="_blank">recommends a similar strategy</a>: &#8220;With a few exceptions, the worst mistake a &#8216;business blog&#8217; can make is to blog about the business.&#8221;</p>
<p>Essentially, the strategy of the corporate blogger, then, should not be to focus on promoting his or her own company&#8217;s products or services so much, because the blogger has no trust with these topics. The agenda is too obvious, and the blogger lacks currency. But neither should the blogger completely dismiss the topics either, because then the blog ceases to be relevant to readers (sin #2).</p>
<p>Instead, according to Bernoff, the corporate blogger should focus on the company&#8217;s customers, their problems, their successes, their questions, and perspectives. As corporate bloggers shift focus away from a marketing mindset, they will begin to develop relationships with their readers, and those readers may start to feel trust.</p>
<p>Bernoff says Rubbermaid&#8217;s blog does a good example of focusing on the customer more than Rubbermaid. However, I&#8217;m not really into <a href="http://blog.rubbermaid.com/" target="_blank">Rubbermaid</a>, as adventurous as organization can be. A more relevant example in tech comm is Techsmith&#8217;s <a href="http://visuallounge.techsmith.com/2009/08/screencast_of_the_week_-_tom_g.html" target="_blank">Visual Lounge blog</a>. Once a week, they showcase videos created by people who use Camtasia Studio. By focusing on user videos, they aren&#8217;t so much shining the spotlight on themselves as much as their customers. Not all the posts have this focus, though. That&#8217;s okay, because although user problems and solutions are intriguing, a blog can also succeed by establishing relevance with readers.</p>
<p><a href="http://www.scriptorium.com/blog" target="_blank">Palimpsest</a> from Sarah O&#8217;Keefe and <a href="http://4jsgroup.blogspot.com/" target="_blank">The Content Pool</a> from Alan Porter are also written by &#8220;corporate bloggers.&#8221; But with each of these blogs, I don&#8217;t think of them as company blogs. I think of them as blogs written by industry experts. This is partly because their posts rarely promote their company&#8217;s products and services.</p>
<p>In the spirit of transparency, you should know that TechSmith, O&#8217;Keefe, and Porter all advertise in the sidebar of my blog. And I&#8217;m presenting at a conference sponsored by WebWorks. Does that conflict of interest perhaps remove some of the currency of my recommendations? In a way, yes &#8212; even though what I&#8217;ve said is perfectly true.<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/2009/09/15/seven-deadly-sins-of-blogging-1-being-fake/feed/</wfw:commentRss>
		<slash:comments>13</slash:comments>
	
		<series:name><![CDATA[Seven Sins of Blogging]]></series:name>
	</item>
		<item>
		<title>Richard Hamilton&#8217;s XML Press Imprint</title>
		<link>http://idratherbewriting.com/2009/05/25/richard-hamiltons-xml-press-imprint-podcast/</link>
		<comments>http://idratherbewriting.com/2009/05/25/richard-hamiltons-xml-press-imprint-podcast/#comments</comments>
		<pubDate>Tue, 26 May 2009 03:51:45 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[Podcasts]]></category>
		<category><![CDATA[Alan Porter]]></category>
		<category><![CDATA[Anne Gentle]]></category>
		<category><![CDATA[publishing]]></category>
		<category><![CDATA[richard hamilton]]></category>
		<category><![CDATA[technical communicators]]></category>
		<category><![CDATA[xml press]]></category>

		<guid isPermaLink="false">http://www.idratherbewriting.com/?p=3579</guid>
		<description><![CDATA[Download MP3 Length: 9 min. In this podcast, I talk with Richard Hamilton about his new publishing imprint, XML Press. Richard started XML Press to serve the needs of technical communicators, publishing books on topics that may not get traction from large publishing houses due to the limited audience, but which perfectly fit a smaller, niche technical communication audience. Focusing on practical topics that technical ... <a href="http://idratherbewriting.com/2009/05/25/richard-hamiltons-xml-press-imprint-podcast/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<p><a href="http://www.podtrac.com/pts/redirect.mp3?http://idratherbewriting.com/podcasts/xmlpress.mp3">Download MP3</a><br />
Length: 9 min.</p>
<p>In this podcast, I talk with <a href="http://rlhamilton.wordpress.com/" target="_blank">Richard Hamilton</a> about his new publishing imprint, <a href="http://xmlpress.net" target="_blank">XML Press</a>. Richard started XML Press to serve the needs of technical communicators, publishing books on topics that may not get traction from large publishing houses due to the limited audience, but which perfectly fit a smaller, niche technical communication audience. Focusing on practical topics that technical communicators can use to improve their jobs, XML Press already has one book available and two forthcoming:</p>
<ul>
<li> <a href="http://xmlpress.net/publications/managing-writers/" target="_blank">Managing Writers: A Real World Guide to Managing Technical Documentation</a>, by Richard Hamilton</li>
<li> <a href="http://xmlpress.net/publications/wiki-how-to-grow/" target="_blank">Wiki: Grow Your Own for Fun and Profit,</a> by <a href="http://4jsgroup.blogspot.com/" target="_blank">Alan J. Porter</a> (coming soon)</li>
<li> <a href="http://xmlpress.net/publications/conversation-community/" target="_blank">Conversation and Community: The Social Web for Documentation</a>, by <a href="http://justwriteclick.com" target="_blank">Ann Gentle </a>(coming soon)</li>
</ul>
<p>Richard is looking for topics related to technical communication and XML. If you’re looking to write a book on technical communication, be sure to check out <a href="http://xmlpress.net" target="_blank">XML Press</a>. Richard also has a <a href="http://rlhamilton.wordpress.com/" target="_blank">blog called Managing Writers</a>.<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/2009/05/25/richard-hamiltons-xml-press-imprint-podcast/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
<enclosure url="http://www.podtrac.com/pts/redirect.mp3?http://idratherbewriting.com/podcasts/xmlpress.mp3" length="13812892" type="audio/mpeg" />
		</item>
		<item>
		<title>James Bond: The History of the Illustrated 007 (Podcast with Alan Porter)</title>
		<link>http://idratherbewriting.com/2009/05/11/james-bond-the-history-of-the-illustrated-007-podcast-with-alan-porter/</link>
		<comments>http://idratherbewriting.com/2009/05/11/james-bond-the-history-of-the-illustrated-007-podcast-with-alan-porter/#comments</comments>
		<pubDate>Tue, 12 May 2009 04:23:49 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[Podcasts]]></category>
		<category><![CDATA[007]]></category>
		<category><![CDATA[Alan Porter]]></category>
		<category><![CDATA[comic books]]></category>
		<category><![CDATA[comics]]></category>
		<category><![CDATA[james bond]]></category>
		<category><![CDATA[WebWorks]]></category>

		<guid isPermaLink="false">http://www.idratherbewriting.com/?p=3510</guid>
		<description><![CDATA[Download MP3 (to download, right-click and select Save Target As) Length: 7 min. James Bond: The History of the Illustrated 007 is Alan Porter&#8217;s latest book. Alan Porter is vice president of Operations at Webworks, and I&#8217;ve interviewed him before about their extensive use of wikis. Obviously James Bond isn&#8217;t a person that comes to mind when we think of technical communicators, but Alan explains  ... <a href="http://idratherbewriting.com/2009/05/11/james-bond-the-history-of-the-illustrated-007-podcast-with-alan-porter/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<div class="wp-caption alignright" style="width: 250px"><a href="http://www.amazon.com/James-Bond-History-Illustrated-007/dp/1932563180"><img title="James Bond: The History of the Illustrated 007" src="http://ecx.images-amazon.com/images/I/51D5VwmallL._SL500_AA240_.jpg" alt="James Bond: The History of the Illustrated 007" width="240" height="240" /></a><p class="wp-caption-text">James Bond: The History of the Illustrated 007</p></div>
<p><a title="James Bond" href="http://www.podtrac.com/pts/redirect.mp3?http://idratherbewriting.com/podcasts/porteronbond.mp3">Download MP3</a> (to download, right-click and select Save Target As)<br />
Length: 7 min.</p>
<p><em>James Bond: The History of the Illustrated 007</em> is Alan Porter&#8217;s latest book. Alan Porter is vice president of Operations at <a href="http://webworks.com/" target="_blank">Webworks</a>, and I&#8217;ve interviewed him before <a href="http://www.idratherbewriting.com/2008/05/06/podcast-pushing-your-company-into-the-wikis-blogs-and-social-networks-of-web-20-interview-with-alan-porter-of-webworks/" target="_blank">about their extensive use of wikis</a>. Obviously James Bond isn&#8217;t a person that comes to mind when we think of technical communicators, but Alan explains  the appeal of the Bond character from a technical writer&#8217;s perspective.</p>
<p>I had the chance to flip through the James Bond book at the STC Summit bookstore, and I was impressed by the quality. Full color pages, large format, insightful commentary on each page. This book would make an interesting read, especially given the longstanding appeal of Bond in comics, novels, and movies.</p>
<p><a href="http://www.amazon.com/James-Bond-History-Illustrated-007/dp/1932563180" target="_blank">Buy James Bond: The History of the Illustrated 007</a> from Amazon.<a href="http://4jsgroup.blogspot.com/" target="_blank"></a></p>
<p><a href="http://4jsgroup.blogspot.com/" target="_blank">View Alan Porter&#8217;s blog</a><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/2009/05/11/james-bond-the-history-of-the-illustrated-007-podcast-with-alan-porter/feed/</wfw:commentRss>
		<slash:comments>3</slash:comments>
<enclosure url="http://www.podtrac.com/pts/redirect.mp3?http://idratherbewriting.com/podcasts/porteronbond.mp3" length="12789129" type="audio/mpeg" />
		</item>
		<item>
		<title>STC Summit Atlanta Adventures: The Agony and Ecstasy of Presenting</title>
		<link>http://idratherbewriting.com/2009/05/08/stc-summit-atlanta-adventures-the-agony-and-ecstasy-of-presenting/</link>
		<comments>http://idratherbewriting.com/2009/05/08/stc-summit-atlanta-adventures-the-agony-and-ecstasy-of-presenting/#comments</comments>
		<pubDate>Fri, 08 May 2009 22:57:34 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[blog]]></category>
		<category><![CDATA[Alan Porter]]></category>
		<category><![CDATA[atlanta]]></category>
		<category><![CDATA[Ben Minson]]></category>
		<category><![CDATA[caroline jarrett]]></category>
		<category><![CDATA[chauncey wilson]]></category>
		<category><![CDATA[david pogue]]></category>
		<category><![CDATA[delivery]]></category>
		<category><![CDATA[Ginny Redish]]></category>
		<category><![CDATA[james bond]]></category>
		<category><![CDATA[mary deaton]]></category>
		<category><![CDATA[PowerPoint]]></category>
		<category><![CDATA[preparation]]></category>
		<category><![CDATA[Presenting]]></category>
		<category><![CDATA[prototyping]]></category>
		<category><![CDATA[Sarah O'Keefe]]></category>
		<category><![CDATA[slides]]></category>
		<category><![CDATA[STC]]></category>
		<category><![CDATA[STC Summit]]></category>
		<category><![CDATA[Technical Writing]]></category>
		<category><![CDATA[visio]]></category>

		<guid isPermaLink="false">http://www.idratherbewriting.com/?p=3500</guid>
		<description><![CDATA[This week I returned from the annual STC Summit in Atlanta. Every year is always a series of adventures at these conferences. I&#8217;d never been to Atlanta before. I arrived a day early, because I was originally scheduled to give a workshop on blogging, but it was canceled due to lack of participants. Attendance at the STC Summit overall was down by about 35%. I ... <a href="http://idratherbewriting.com/2009/05/08/stc-summit-atlanta-adventures-the-agony-and-ecstasy-of-presenting/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<div id="attachment_3501" class="wp-caption alignright" style="width: 212px"><img class="size-full wp-image-3501" title="STC Summit in Atlanta" src="http://www.idratherbewriting.com/wp-content/uploads/2009/05/summitlogo.jpg" alt="STC Summit in Atlanta" width="202" height="192" /><p class="wp-caption-text">STC Summit in Atlanta</p></div>
<p>This week I returned from the annual <a href="http://conference.stc.org/">STC Summit in Atlanta</a>. Every year is always a series of adventures at these conferences. I&#8217;d never been to Atlanta before. I arrived a day early, because I was originally scheduled to give a workshop on blogging, but it was canceled due to lack of participants. Attendance at the STC Summit overall was down by about 35%. I was relieved, however, at not having to put together a long workshop in addition to three conference presentations.</p>
<p>As soon as I got to the hotel, I ran into Alan Houser, the program chair of the conference, who asked if I wanted to eat dinner. I attribute much of my good luck in getting conference proposals carefully considered to the fact that Alan is a long-time listener of my podcasts.</p>
<p>The next day I decided to get some exercise. I&#8217;d been reading about a Run-n-Shoot Athletic Center, which had 10 indoor basketball gyms. The concierge confirmed the place existed, even though they never answered their phone. I took a train and then bus out into the West End to find the place. Getting outside the downtown district with all the fancy hotel and conference centers was an eye-opener, reminding me of scenes from the Bronx.</p>
<p>When I finally got to the address, the Run-n-Shoot center had been converted into a fitness center, the gyms converted to bowling alleys and skating rinks and playlands. The only remaining basketball court had a limited court time that ended a few hours ago.</p>
<p>I returned to the hotel and worked on my presentations some more. A couple of years ago, I was converted to a visual-based method of presenting. I hate extended bullets on slides, so my slides consist of nothing more than a title and an image. <span id="more-3500"></span></p>
<p>To find the right images, I sometimes drag icons from Visio into Illustrator, make a few tweaks, drag them to Photoshop, make some more adjustments, flatten them, and then insert them into PowerPoint. The way I set up my blogging presentation, each slide was supposed to trigger a story, and then I had several points to cover, which I hoped to magically remember during the presentation without having a bulleted lists on the slide. This flexibility allowed me to go with the flow as I presented.</p>
<p>As I looked through the program, I realized that for some reason my presentation was an hour and a half instead of an hour. I only prepared for an hour and wondered when they might have told me my presentation was supposed to be 90 minutes instead of 60. They probably did tell me at some point—long ago—but my email inbox has a constant stream of messages that I often miss. I decided to splice in some tips on blog usability that I&#8217;d given in another presentation, just in case.</p>
<p>The Sunday before the conference begins is Leadership day. A few years ago I attended Leadership Day in Minneapolis and was excited about it, since I was a new chapter president at the time. This time around, however, I found my interest anemic almost from the start. Even with the first speaker, I surfed on my Windows mobile instead. It turns out the Society is either $500,000 or a million dollars in debt, and plans to rely partly on chapter finances to make it through. (Since our chapter seems to have an annual budget of $5 anyway, the restricted budget didn&#8217;t seem to have much impact, but quite a few people were vocal about it.)</p>
<p>After slipping away from Leadership Day, I returned to my hotel room to work on my presentation, to read more of Gladwell&#8217;s <em>Outliers</em> (which had totally hooked me on the plane), and to nap a bit.</p>
<p>The opening keynote by <a href="http://www.davidpogue.com/">David Pogue</a> the next morning was engaging and completely interesting—not so much because of his message, which was about the power of simplicity, but because of his theatrical, dynamic style. He knows how to deliver a keynote. I was laughing, shaking my head in agreement, twittering about it. The whole place was mesmerized. His presentation skills filled me a bit with dread towards my upcoming presentations, because I knew I couldn&#8217;t present like that.</p>
<p>Later that evening, I ran into Kirsty Taylor from Australia. I knew her from comments on my blog and Twitter, but she really is a fan of my wife&#8217;s blog, <a href="http://whataboutmomblog.com">whataboutmomblog.com</a>. She said she had some gifts from Australia for Jane and the kids. This amazed me—that she&#8217;d brought gifts all the way from Australia. I know I have a lot of blog readers, but my wife has blog <em>disciples</em>. I later interviewed Kirsty for a podcast, asking her why some blogs inspire devoted followers while others, like mine, simply invite casual attention. Not surprisingly, it&#8217;s the personal aspect of the blog, she said. Speaking to the reader&#8217;s heart and revealing appropriately, she explained.</p>
<p>When I presented on blogging, the session was full. I found I was able to remember most of what I planned to say, and not having bullet-by-bullet points on slides resulted in a conversation-like style, someone later told me. I breathed well and didn&#8217;t run out of content for the full hour and a half. My back started to hurt, though, from standing in the same general place so long.</p>
<p>I&#8217;m glad I had the opportunity to present on a topic I&#8217;m so passionate about. There are many things I&#8217;m somewhat knowledgeable about, but only a few things I&#8217;m truly passionate about. Blogging is one of them. My passion for it was apparent, and this enthusiasm made any nervousness disappear.</p>
<p>It seemed that after my blogging session, I ran into people I knew everywhere. Not just people who listened to the session, but people who had been following my blog, people in past chapters, past conferences, people whose blogs I followed, or people I knew from Twitter, and so on. I could hardly walk through a room without running into someone I knew, or encountering someone who knew me and wanted to say hello. My colleagues later told me that I was &#8220;amazingly social,&#8221; even though I find that comment surprising still.</p>
<p>After my blogging presentation ended, I started thinking about my next presentation—a 20 minute presentation about usability (&#8220;What you learn by watching others use your documentation&#8221;) in the Usability SIG progression. Usability is not my strength, but I&#8217;d given a videocast and written a post or two on the topic, which caught the attention of a SIG coordinator and he invited me to speak at a progression table.</p>
<p>I remembered a video I&#8217;d taken of <a href="http://www.idratherbewriting.com/2009/03/02/emotional-states-of-computer-users-in-times-of-frustration/">Jane being frustrated</a> at the computer, and I decided to use it to open up a few observations about what users do when they&#8217;re frustrated. Mainly, they don&#8217;t use help, even when they&#8217;re wringing their hands and cringing. I recommended moving the help into the interface, following some pointers <a href="http://user-assistance.blogspot.com/">Mike Hughes</a> gave me <a href="http://www.idratherbewriting.com/2009/01/31/podcast-make-your-help-indispensable-safeguard-your-job/">in a podcast months before</a>.</p>
<p>Progressions work differently from normal presentations. About six different presenters have round tables that seat a dozen people. Participants go from table to table, switching tables three times during the hour.</p>
<p>My table was next to some well-known experts in the field—<a href="http://www.redish.net/">Ginny Redish</a>, <a href="http://www.interaction-design.org/references/authors/caroline_jarrett.html">Caroline Jarrett</a>, <a href="http://www.seaconinc.com/">Karen Bachman</a>, <a href="http://www.wqusability.com/">Whitney Quesenbury</a>, <a href="http://www.bentley.edu/info-design-certificate/faculty.cfm">Chauncey Wilson</a>, and <a href="http://www.mmdeaton.com/">Mary Deaton</a>. Almost every one of them has either written books on usability or works as a usability consultant. When the SIG progression leader introduced me, she said, &#8220;And at the back table, we have the famous Tom Johnson …&#8221;</p>
<p>I thought this was funny, but it turned out to be somewhat true. It seemed that practically everyone knew me from my blog or podcasts. Even people I didn&#8217;t think knew me later added, casually during a conversation, &#8220;I feel like I&#8217;m in one of your podcasts, listening to your voice.&#8221;</p>
<p>My presentation wasn&#8217;t outstanding, but I don&#8217;t think it was bad either. Some said that overall the progression was the best progression they attended (I&#8217;m not sure if the same people actually came to my table). But I have to admit the progression format turns me off a little. It&#8217;s noisy. It&#8217;s weird. It&#8217;s short and seems rushed. Not many other people I met liked the progression format either.</p>
<p>I had one more presentation to give, this one a co-presentation with <a href="http://gryphonmountain.net">my Gryphon Mountain colleague</a> about quick reference guides. Co-presentations, I&#8217;ve decided, are actually more difficult than single presentations, because you have to make sure the other presenter is prepared and that he or she won&#8217;t overlap topics, that your handoffs will be seamless, that you will appear as one rather than switching back and forth in awkward ways.</p>
<p>Also, I was a little concerned because my colleague was fairly new to presenting. He&#8217;d never presented at the Summit before, and he had a soft-spoken voice that made him hard to hear. I told him to speak up and avoid slipping into a monotone rhythm. He had a few note cards he used to remember his points on various slides, as did I.</p>
<p>The presentation wasn&#8217;t until late in the next day, so we still had some time. While walking about the vendor expo and meeting with people, I ran into incoming <a href="http://www.stctoronto.org/">STC Toronto</a> president Anna Parker-Richards, who I didn&#8217;t know. But as she was talking to me, I asked her about her chapter&#8217;s new meeting model, in which they charge $100 to $150 per meeting (or &#8220;event&#8221;). What she explained—the &#8220;Five and Five Model&#8221;—was so interesting I decided to record a podcast with her right there. That interview got me in the mood to record other podcasts, and soon I started carrying around my Zoom H4 recorder everywhere.</p>
<p>I interviewed Ginny Redish about her book <a href="http://www.amazon.com/Letting-Go-Words-Interactive-Technologies/dp/0123694868"><em>Letting Go of the Words</em></a> (which is really about writing web content). I interviewed Caroline Jarrett about her book on forms (<a href="http://www.formsthatwork.com/"><em>Forms that Work</em></a>) and why forms are important and interesting. I talked with Mike Hamilton about Madcap&#8217;s upcoming Flare-DITA solution, to Alan Porter about his book, the <em>History of the Illustrated James Bond</em> (and how James Bond relates perfectly to technical communicators). I talked with Sarah O&#8217;Keefe about her latest study on <a href="http://www.scriptorium.com/palimpsest/2009/04/structured-authoring-in-technical.html">the state of structured authoring</a>. I even spoke with some guy from the Netherlands and his method for prototyping with refrigerator magnets.</p>
<p>Tracking people down for podcasts is mostly a matter of chance. If I ever had a conversation with someone who was particularly interesting, addressing something new, such as a book or study or trend, I pulled out my recorder and asked if I could do a podcast right there. (When it comes to podcasting, I have no reservations about approaching a total stranger and interviewing him or her for a podcast. It makes the conference so much fun.)</p>
<p>Our quick reference guide session was scheduled for 5 p.m. on Tuesday—unfortunately at the end of the day, when everyone is tired. My colleague and I skipped some of the afternoon sessions to prepare. He practiced in the room, saying aloud his parts. On one slide I thought he had too many points for the lack of visuals, so I asked if he could make the commentary during some of the example slides. I rehearsed what I planned to say about design, but had to ultimately concede that, as much as I tried explaining it, design was like music. You could try to describe and explain how it works, but it was slippery and hard to pin down. Designs that work just feel right, regardless of any specific principles.</p>
<p>At five o&#8217;clock, the room was packed. No chairs were empty, people stood at the back and sides of the room, and there were even about 7 or 8 people watching from the hallway.</p>
<p>The lapel microphone wouldn&#8217;t stick on my colleague&#8217;s floppy shirt collar, so he held it in his hand. I buttoned up my shirt collar a notch so the lapel mic would be closer to my mouth. It worked, even if I looked nerdy. The room lacked a wireless mouse clicker, but at the last minute Jackie Damrau (who received a president&#8217;s award at the conference) retrieved one from her hotel room for us.</p>
<p>To start the presentation, my colleague began reading, in a funny voice, a cartoon he&#8217;d drawn. This made people laugh. Then we launched into the presentation. It went well for about the first 20 minutes, and more and more people started coming into the room. I could hardly believe how popular the session was.</p>
<p>Little by little, raised hands started to appear in the audience. First one hand, and then another, and another. It seemed everyone had questions to ask, which we tried to answer. Some of our answers related to slides to come, but I thought it best to give the answer now, with full elaboration, rather than wait. I think that proved to be a bit of mistake, because too many questions can kill the flow and rhythm of a presentation. For everyone that asks a question, there&#8217;s another person that doesn&#8217;t want to listen to someone asking a question.</p>
<p>Still, the majority of people remained engaged and interested in what we had to say. The quick reference guide examples provided visual appeal and were practical. My colleague projected well and covered good ground. More than a dozen attendees stayed after to talk to us individually, and for the next day people complimented us on the presentation.</p>
<p>But later in the evening, when we returned to our hotel room and checked the <a href="http://search.twitter.com/search?q=stc09">STC 09 Twitter feed</a>, a <a href="http://twitter.com/tessercat/statuses/1710521055">tweet</a> did provide a bit of a downer, because the person said we needed a moderator, more concrete examples, and that we were more frustrating than interesting. Negative feedback is sometimes hard to take, but it is more instructive in the long run, and I could see how to improve our delivery the next time.</p>
<p>That night, even with the sour tweet, having completed all my presentations, I felt a burden lifted from me. At the same time I wanted to collapse from exhaustion. I went to dinner with my colleagues and a few new friends. I thought a woman who joined us (Trina) had a foreign accent, but she turned out to just be from Milwaukee. Another LDS technical writer from Connecticut (Chris Keeling) joined us. A former drill sergeant and game aficionado, he had a love for his old blind and deaf cat, which he gave an IV to every day, he explained. The cat also drooled on his head in the morning. He and another woman, coincidentally, were both former military intelligence officers who translated Russian, or something.</p>
<p>As the night ticked away, I couldn&#8217;t help but feel satisfied both emotionally now that the presentations were over and physically now that I was eating.</p>
<p>After the final conference luncheon the next day, I still had a few more hours to kill. I had a goal to interview ten people for podcasts, and given my theme of recently published books, Karen Bachman recommended I talk with <a href="http://www.hedtke.com/">John Hedtke</a>, who has <a href="http://www.hedtke.com/books.htm">published 26 books</a>, his most recent one on <a href="http://www.amazon.com/Complete-Idiots-Guide-Disaster-Preparedness/dp/1592578934">Disaster Preparedness</a>.</p>
<p>This was my first encounter with John. He was articulate and well-spoken. He explained why he wrote about disaster preparedness—&#8221;for the money,&#8221; he said. I prodded him a little more. Perhaps you had a disaster in your own life that motivated you to explore this topic? I asked. No, he said. I really just wrote it for the money.</p>
<p>While I was talking with him, though, he mentioned that he wrote in the evenings and weekends, after work. You mean you have a regular day job besides your book writing projects? I asked.</p>
<p>Apparently, yes. Computer books (most of what he&#8217;s written) have a short shelf-life, he explained. And most nonfiction books don&#8217;t make back their advance checks, which are usually between six to ten thousand dollars. Listening to John made me think twice about book publishing.</p>
<p>Regardless of whether I ever write a book, I reflected on the idea for a while in a dreamy way—thinking about possibilities and topics and who might publish it and whether it would be in color or not. Shortly after my conversation with John, I flew home.</p>
<p>Overall, the Summit is always a good experience because it gets me engaged in the profession. It engages me with presentations, which requires my best thinking, organizing, and delivery skills. It engages me with podcasts, interviewing people on the spot, drilling deeper into their knowledge. It engages me with new ideas through sessions from experts and authorities in the field. And it engages me with a new environment, surrounding me with new friends and a new city. It is a short stretch of time, about four or five days, but its effects last throughout the year.</p>
<p>By the way, this year all presentations (except the progressions) were recorded. You can buy the presentations from the STC (called Summit@aClick) for a price (no one knows how much yet). I&#8217;m told that I can also post my own presentations on my blog for free, which I&#8217;ll certainly do when they&#8217;re available.</p>
<p>If you enjoyed this writeup, see my write-ups from previous conferences:</p>
<ul>
<li><a href="http://www.idratherbewriting.com/2008/06/07/technical-writer-as-conversation-stopper-and-other-notes-from-the-stc-summit-in-philadelphia/" target="_self">Technical Writer as Conversation Stopper, and Other Notes from the STC Summit in Philadelphia</a></li>
<li><a href="http://www.idratherbewriting.com/2007/05/19/podcasting-at-the-stc-conference-reasons-methods-and-reflections/" target="_self">Podcasting at the STC Conference: Reasons, Methods, and Reflections</a></li>
<li><a href="http://www.idratherbewriting.com/2008/05/12/post-doc-train-thoughts-sitting-in-the-vancouver-airport/" target="_self">Post Doc-Train Thoughts While Sitting in the Airport in vancouver</a></li>
</ul>
<p>
<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/2009/05/08/stc-summit-atlanta-adventures-the-agony-and-ecstasy-of-presenting/feed/</wfw:commentRss>
		<slash:comments>16</slash:comments>
		</item>
		<item>
		<title>Generations Change, But Help Formats Remain the Same?</title>
		<link>http://idratherbewriting.com/2008/12/09/generations-change-but-help-formats-remain-the-same/</link>
		<comments>http://idratherbewriting.com/2008/12/09/generations-change-but-help-formats-remain-the-same/#comments</comments>
		<pubDate>Tue, 09 Dec 2008 13:45:37 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[blog]]></category>
		<category><![CDATA[Alan Porter]]></category>
		<category><![CDATA[DITA]]></category>
		<category><![CDATA[Facebook]]></category>
		<category><![CDATA[generations]]></category>
		<category><![CDATA[homework]]></category>
		<category><![CDATA[instant messaging]]></category>
		<category><![CDATA[IT Author]]></category>
		<category><![CDATA[online help]]></category>
		<category><![CDATA[paradigms]]></category>
		<category><![CDATA[printed manuals]]></category>
		<category><![CDATA[reference manual]]></category>
		<category><![CDATA[Technical Writing]]></category>
		<category><![CDATA[technology]]></category>
		<category><![CDATA[wikipedia]]></category>

		<guid isPermaLink="false">http://www.idratherbewriting.com/?p=2447</guid>
		<description><![CDATA[Today should have been a day of great excitement, almost like a coronation. Having struggled with a 175 page user manual for several months, I finally finished a first draft. Today I met with the client, alongside the senior project manager, the project manager, and a few others to present the sacred document, with the words &#8220;Reference Manual&#8221; on the front. I say it should ... <a href="http://idratherbewriting.com/2008/12/09/generations-change-but-help-formats-remain-the-same/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<p>Today should have been a day of great excitement, almost like a coronation. Having struggled with a 175 page user manual for several months, I finally finished a first draft. Today I met with the client, alongside the senior project manager, the project manager, and a few others to present the sacred document, with the words &#8220;Reference Manual&#8221; on the front.</p>
<p>I say it should have been a day of celebration. Instead, it was an event I knew was out of date. The client flipped through the manual, glancing. He then set it down and we talked about reviewing schedules, because no one felt the client would actually read the manual on his own. Yes, we had to nail down a schedule and force him to choke it down in weekly bites.</p>
<p>In truth, I dislike delivering &#8220;the manual.&#8221;</p>
<p>In &#8220;<a href="http://4jsgroup.blogspot.com/2008/12/move-over-dita-chaos-is-coming.html">Move over DITA – Chaos Is Coming!</a>,&#8221; Alan Porter suggests that rigid structural writing, such as DITA, is at odds with the looser, more chaotic social media so prevalent among the younger generation.  Rather than trying to force-fit the DITA standard onto our documentation, he says we might instead &#8220;step back and look at how [our] kids do their homework. Because in five to ten years they will be [our] new workforce, and perhaps more importantly, [our] new customers.&#8221; <span id="more-2447"></span></p>
<p>In other words, we should rethink our documentation model. Rather than a rigid structure, we might consider following the pattern of how people actually access and use information today.</p>
<p>Exactly how do kids do homework these days? Alan says his daughter uses a variety of social media applications &#8212; wikis, social networks, instant messenger, folksonomies, social bookmarking. Observing his daughter complete her homework, he writes,</p>
<blockquote><p>The first thing she did was google &#8220;Pearl Harbor&#8221; and started visiting links. First stop was Wikipedia. Then she got on Facebook and YahooIM and started using messaging to ask friends who were online for recommendations. These friends were literally from all around the world, so she was given access to resources that gave totally different perspectives than those given in the classroom. …One friend suggested going to a social bookmarking site and searching using a variety of user applied tags. Instead of taxonomy she was now applying folksonomy.</p></blockquote>
<p>In a <a href="http://www.itauthor.eu/2008/11/23/itauthor-podcast-21-three-generations-of-computer-users-part-2/">recent IT Author podcast</a>, Alistair Christie interviews his daughter about how she uses computers, and his daughter explains that she never uses the help, because it&#8217;s almost impossible to find what you&#8217;re looking for. Instead she learns by simply using the interface, clicking buttons, looking at labels, and asking others for help if she needs it. The world of traditional help deliverables &#8212; long manuals with table of contents and indexes, expandable books in online help, even video tutorials &#8212; these all seem last resorts in user&#8217;s mind.</p>
<p>I don&#8217;t use the DITA model, but I do use standard topic-based authoring methodology, single-sourcing between online help and a printed PDF. Reading Alan&#8217;s post and listening to Alistair&#8217;s podcast, as well as hearing  the feedback I always hear about help –- &#8220;I try to learn the application on my own first, and only turn to the help when I&#8217;m stuck&#8221; –- makes me think the old-school paradigms of help (the manual and the online help) are falling by the wayside. They aren&#8217;t harnessing the latest social media technologies. They aren&#8217;t appealing formats.</p>
<p>Alan also observes a sad truth:</p>
<blockquote><p>For most of my working life to date, the technology I used at work far outpaced that I used outside of work.</p>
<p>But not any more.</p>
<p>Now the technology I use at home has generally outpaced that found in most workplaces.</p></blockquote>
<p>This is the tragedy of technical communication. Rather than embracing and leveraging the latest web technologies, tech comm is stuck in the early 1990&#8242;s, delivering the same old content that no one wants and few can make sense of.<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/2008/12/09/generations-change-but-help-formats-remain-the-same/feed/</wfw:commentRss>
		<slash:comments>11</slash:comments>
		</item>
		<item>
		<title>Corporate Migration to the Blogosphere</title>
		<link>http://idratherbewriting.com/2008/08/27/corporate-migration-to-the-blogosphere/</link>
		<comments>http://idratherbewriting.com/2008/08/27/corporate-migration-to-the-blogosphere/#comments</comments>
		<pubDate>Thu, 28 Aug 2008 04:37:43 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[blog]]></category>
		<category><![CDATA[Adobe]]></category>
		<category><![CDATA[Alan Porter]]></category>
		<category><![CDATA[AuthorIt]]></category>
		<category><![CDATA[Blogging]]></category>
		<category><![CDATA[future]]></category>
		<category><![CDATA[MadCap Software]]></category>
		<category><![CDATA[Mike Hamilton]]></category>
		<category><![CDATA[predictions]]></category>
		<category><![CDATA[RJ Jacquez]]></category>
		<category><![CDATA[WebWorks]]></category>

		<guid isPermaLink="false">http://www.idratherbewriting.com/?p=1873</guid>
		<description><![CDATA[A few months ago, I started to write a post about the cultural shift blogging would create in the near and long-term future. I didn&#8217;t get very far and quickly became mired in speculation. But when I learned today that RJ Jacquez now has a blog, I started to remember some of my predictions. Basically, it goes like this: Amateur bloggers start to saturate Google ... <a href="http://idratherbewriting.com/2008/08/27/corporate-migration-to-the-blogosphere/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<div id="attachment_1878" class="wp-caption alignright" style="width: 160px"><a href="http://www.idratherbewriting.com/wp-content/uploads/2008/08/futurepower.jpg"><img src="http://www.idratherbewriting.com/wp-content/uploads/2008/08/futurepower-150x150.jpg" alt="Looking into the future" title="Behold, the Future" width="150" height="150" class="size-thumbnail wp-image-1878" /></a><p class="wp-caption-text">Looking into the future</p></div>
<p>A few months ago, I started to write a post about the cultural shift blogging would create in the near and long-term future. I didn&#8217;t get very far and quickly became mired in speculation. But when I learned today that RJ Jacquez now has a blog, I started to remember some of my predictions. Basically, it goes like this:</p>
<ol>
<li>Amateur bloggers start to saturate Google with content that controls the reputation of company products.</li>
<li>Companies, fearing a complete loss of voice, start joining the blogosphere in masses.</li>
<li>With so many people writing and publishing daily, information grows to a ridiculous degree and becomes difficult to manage.</li>
<li>Search becomes the only way to find anything.</li>
<li>Writers, especially those gifted at SEO and content creation, and who have a lot of Google karma/page rank, become major corporate players, with more prestige than ever before.</li>
</ol>
<p>And right about there I didn&#8217;t know what came next. I think at some point there&#8217;s a major shift and people move away from the web altogether, embracing a new form. But I couldn&#8217;t figure out the details.</p>
<p>Anyway, <a href="http://blogs.adobe.com/rjacquez/" target="_blank">RJ Jacquez from Adobe</a>, <a href="http://madcapsoftware2.wordpress.com/" target="_blank">Mike Hamilton from Madcap Software</a>, and <a href="http://www.quadralay.com/weblog/aporter/" target="_blank">Alan Porter from WebWorks</a> all have blogs. I suspect <a href="http://authorit.com/" target="_blank">AuthorIt</a> will eventually launch a blog, and the dozens of other software vendors. They&#8217;re realizing that it&#8217;s marketing suicide to be offline and silent.</p>
<p>Although these bloggers are all intelligent, clear writers, with solid reputations to give them an authoritative presence, the question is whether they will have the creative muse to write day after day in a way that engages readers. We&#8217;ll find out.</p>
<p>&#8212;&#8212;&#8212;&#8212;&#8212;-</p>
<p>photo from <a href="http://ucdavismagazine.ucdavis.edu/issues/su07/future_power.html">UCDavis</a></p>
]]></content:encoded>
			<wfw:commentRss>http://idratherbewriting.com/2008/08/27/corporate-migration-to-the-blogosphere/feed/</wfw:commentRss>
		<slash:comments>3</slash:comments>
		</item>
		<item>
		<title>Post Doc-Train Thoughts While Sitting in the Vancouver Airport</title>
		<link>http://idratherbewriting.com/2008/05/12/post-doc-train-thoughts-sitting-in-the-vancouver-airport/</link>
		<comments>http://idratherbewriting.com/2008/05/12/post-doc-train-thoughts-sitting-in-the-vancouver-airport/#comments</comments>
		<pubDate>Mon, 12 May 2008 06:16:42 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[blog]]></category>
		<category><![CDATA[Alan Porter]]></category>
		<category><![CDATA[Anne Gentle]]></category>
		<category><![CDATA[Atlassian Confluence]]></category>
		<category><![CDATA[Darren Barefoot]]></category>
		<category><![CDATA[LDS Church]]></category>
		<category><![CDATA[Noz Urbina]]></category>
		<category><![CDATA[Sara O'Keefe]]></category>
		<category><![CDATA[SharePoint]]></category>
		<category><![CDATA[Stewart Mader]]></category>
		<category><![CDATA[Technical Writing]]></category>
		<category><![CDATA[Theresa Putkey]]></category>
		<category><![CDATA[Twitter]]></category>

		<guid isPermaLink="false">http://www.idratherbewriting.com/?p=1517</guid>
		<description><![CDATA[Doc Train has ended, and I&#8217;m sitting at the Vancouver airport waiting for my airplane. Lots of thoughts are coming to my head, in no particular order. I interviewed about 12 people this year. I seem to have a knack for this &#8212; tracking people down, asking if I can interview them, getting them talking, etc. Actually, it has taken me three conferences to get ... <a href="http://idratherbewriting.com/2008/05/12/post-doc-train-thoughts-sitting-in-the-vancouver-airport/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<p><a href="http://www.idratherbewriting.com/wp-content/uploads/2008/05/228015304_b48176a150_m.jpg"><img class="alignright size-full wp-image-1518" style="margin: 5px; float: right;" title="Leaving Vancouver" src="http://www.idratherbewriting.com/wp-content/uploads/2008/05/228015304_b48176a150_m.jpg" alt="Leaving Vancouver" width="240" height="180" /></a><a href="http://doctrain.com/west">Doc Train</a> has ended, and I&#8217;m sitting at the Vancouver airport waiting for my airplane. Lots of thoughts are coming to my head, in no particular order.</p>
<p>I interviewed about 12 people this year. I seem to have a knack for this &#8212; tracking people down, asking if I can interview them, getting them talking, etc.</p>
<p>Actually, it has taken me three conferences to get this right. Last year, at Doc Train West 2007, I didn&#8217;t have the right setup. I tried using a lavalier mic attached to the mic port of a Mac I borrowed. But I didn&#8217;t realize the Mac wasn&#8217;t reading the lavalier; it was using a built-in mic.</p>
<p>Then at the STC Summit in Minneapolis, I had the right equipment (a portal Zoom H4 recorder), but by and large I interviewed the wrong people in the wrong places. I did interview some presenters, but I spent too much time interviewing attendees.</p>
<p>This year at Doc Train West 2008, I had the right equipment and I talked to the right people in the right spaces. And it worked extremely well. I give you this advice if you ever try recording live interviews at conferences:</p>
<ul>
<li> Buy an <a href="http://www.idratherbewriting.com/2008/03/12/six-ways-im-using-the-h4-zoom-recorder-to-change-my-technical-writing-world/">H4 Zoom recorder</a>.</li>
<li> Use the built-in mics rather than an external mic.</li>
<li> Interview people who are giving presentations.</li>
<li> Find a quiet room where you can sit down with them.</li>
</ul>
<p>Really the key is to interview presenters, because they automatically have something to say. They have a message they&#8217;ve been cramming and practicing. Conversations flow naturally, and they give you great content. In contrast, attendees have much less to say. <span id="more-1517"></span></p>
<p>By and large interviewing is weird. I&#8217;m not a radio geek, I never did audio as a teenager. I just fell into podcasting and became a podcaster. It takes some tact and boldness to interview people at conferences. I think I learned this skill as a missionary in Venezuela &#8212; a two year period where I spent almost every hour of the day talking to people I didn&#8217;t know. Strangely, there are a ton of comparisons between being a missionary and seeking people to interview as a podcaster. You have to open your mouth, even when you&#8217;re shy. You invite them to sit down and talk with you. You have to initiate contact and be a good listener. Okay, enough of that.</p>
<p>But seriously, it gets even weirder because now that I work for the <a href="http://lds.org">Church</a>, I had &#8220;LDS Church&#8221; printed below my name on my conference tag. This only adds to the questions. One person, seeing my name tag, shared her frustrations with the FLDS situation. Another person asked if I write religious tracts. Another said he was converting all of Scientology&#8217;s documentation to XML. Several people asked if the Church has software and wondered exactly what I do.</p>
<p>The frequency of the last question (does the LDS Church have software?) is a little perplexing. Let&#8217;s say you work for a company with 13 million employees, scattered across the globe, speaking 100+ languages, meeting in thousands of buildings, 120+ special conference centers, with complex financial contribution system, facilities maintenance, an ambassador program with 60,000 nomadic people spread out in geographically diverse locations, with some in delicate states of health. Not to mention numerous external properties, ranches, investments, and other equities. Also include hundreds of committees, with dynamic reporting and information sharing needs. On top of all this, add a twice-yearly general conference held in one location but distributed via satellite, TV, and radio across the globe, translated almost immediately, with a web distribution and extensive resources online. Not to mention handbooks, manuals, pamphlets, and other literary materials, videos, and CDs in multiple languages. Would a company like that need any kind of software to manage all that? Heck yes! Actually, it&#8217;s a miracle that there are only 4 technical writers (and a lot of non-technical writers).</p>
<p>But enough of that. More on the conference. One of the incredible things about blogging is that it really does build relationships. This is especially noticeable at conferences, when you meet people whose blogs you&#8217;ve been reading and you immediately feel like you&#8217;re a close friend, even if it&#8217;s a first-time encounter. I feel I know tons of people at these conferences. I got to meet <a href="http://keypointe.ca/">Theresa Putkey</a> and <a href="http://webworks.com/weblog/aporter/">Alan Porter</a> for the first time, who I just <a href="http://www.idratherbewriting.com/2008/04/02/podcast-transitioning-from-technical-writing-into-usability/">recently</a> <a href="http://www.idratherbewriting.com/2008/05/06/podcast-pushing-your-company-into-the-wikis-blogs-and-social-networks-of-web-20-interview-with-alan-porter-of-webworks/">interviewed</a>. I met other podcast listeners. One listener (&#8220;<a href="http://www.linkedin.com/pub/2/AA6/606">Lisha</a>&#8220;) sat next to me in the same session and showed me the latest podcast she&#8217;d downloaded to her computer.</p>
<p>Were the sessions good? As good as any. I&#8217;m not sure how it happened, but my attention span during sessions has diminished greatly. As soon as a presenter starts droning away at a long bulleted list on a PowerPoint slide, it puts me to sleep. I open up the laptop, check <a href="http://gmail.com">Gmail</a>, <a href="http://twitter.com/tomjohnson1492">Twitter</a>, and before you know it, I&#8217;m only half there.</p>
<p>However, when I&#8217;m interviewing someone for a podcast, I&#8217;m completely engaged. This is because I get to direct the topic and tempo of the conversation. If the interviewee starts to go in an uninteresting direction, I ask a question that brings it back onto the main raceway.</p>
<p>The light bulb moment for me happened during one of these podcast interviews. I was <a href="http://www.idratherbewriting.com/2008/05/11/podcast-living-multiple-lives-the-new-technical-communicator-interview-with-noz-urbina/">talking with Noz Urbina</a>, who delivered a keynote one early morning.  (By the way, when I explained this light bulb moment to my wife, she had little response and later said it was somewhat obvious. Many times the groundwork behind realizations, she said, are laid by numerous experiences, brought together by a simple observation someone states. She&#8217;s right.)</p>
<p>Noz explained that as technical communicators integrate Web 2.0 feedback mechanisms to gather information from users — whether through comments on blogs, contributions to wikis, posts on forums, or other ways — the technical communicator transforms into a much more integral player in the user interface design, the task workflow, and the feature roadmap of the application.</p>
<p>Essentially, when you connect with your users in an integrated way, you become the business analyst, interaction designer, and product manager all in one. You suddenly know what the users want, what the users are experiencing. You are not just writing tech docs. Dude, you are leading the direction of the product!</p>
<p>And as you accrue this user experience knowledge, you begin to influence the project team in the direction they should be going. You become a leader rather than a follower. You aren&#8217;t simply one who takes directions from an exec who isn&#8217;t connected at all to the user base. The execs begins to come to you for information.</p>
<p>As I mentioned earlier, numerous other experiences laid the groundwork for this realization. In my current role on the User Education Team, I write tech docs, online help, quick reference guides, and role-based guides. But I also give training sessions to users, act as a point of contact when users have feature requests or problems, and take occasional support calls when users are confused.</p>
<p>I&#8217;ve been taking all the information I receive and channeling it back to the project leads. And I&#8217;ve noticed that I am contributing user feedback 100 to 1 (compared to what others send). I&#8217;m doing much more than simple technical writing.</p>
<p>As such, the term &#8220;technical writer&#8221; no longer describes what I do. Not even &#8220;technical communicator.&#8221; Right  now I&#8217;d take any wacky term, just to remove the stereotype that a technical writer&#8217;s job is to &#8220;write documentation.&#8221; Information designer, content strategist, user information lead, or whatever.</p>
<p>My light bulb moment was to realize that web 2.0 would forever change the role of the technical writer. The more I enable user feedback and content, the more I will understand users, and the more I understand users, the more central role I&#8217;ll play in defining product roadmaps, guiding interface design, and making other key decisions.</p>
<p>The strange thing is, I don&#8217;t even have any Web 2.0 formats integrated in my help. I deliver static content — online help, quick reference guides, and user guides. And live training. Once I flip on the Web 2.0 switch, the amount of feedback coming in will triple or quadruple, I&#8217;m sure of it.</p>
<p>I also attended several sessions on wikis, including one during the <a href="http://justwriteclick.com/2008/05/10/doctrain-west-2008-how-was-the-unconference/">Unconference</a>. The more I listened to <a href="http://ikiw.org">Stewart Mader</a>, the more I became convinced that wikis are the way to go. I&#8217;ve decided to go in a similar direction with my help deliverables. We have SharePoint 2007 at my organization, and as bad as Microsoft products sometimes are, they got many things right with SharePoint 2007 — namely, blogs, wikis, RSS feeds, and comprehensive search.</p>
<p>I plan to put my documentation into a wiki format, add a product blog, and drive users to this SharePoint site for documentation. Even though <a href="http://www.atlassian.com/software/confluence/">Atlassian Confluence</a> offers better wiki functionality and <a href="http://wordpress.org">WordPress </a>offers better blogging, I&#8217;m using the SharePoint platform for a number of very convincing reasons:</p>
<ul>
<li>My organization already has SharePoint technology, and as much as we&#8217;re open about tools, getting a non-standard technology approved and implemented has proven to be difficult.</li>
<li>SharePoint&#8217;s search looks at content both in the wiki and the blog (and any other site resources). This is critical, and is the reason I&#8217;ve not formalized a blog yet — it couldn&#8217;t be integrated with the Madcap Flare webhelp I was using. Having one search that finds all help content is paramount.</li>
<li>SharePoint&#8217;s wiki allows you to introduce columns (metadata) and sort by those columns. This can help keep a wiki organized and prevent it from degenerating into an &#8220;unmitigated disaster,&#8221; as another conference attendee described her company&#8217;s wiki.</li>
</ul>
<p>Overall, usually applications either excel at blogs or wikis, but not both. You compromise with one or the other. I&#8217;m willing to compromise, and I plan to experiment with any <a href="http://www.codeplex.com/CKS/Wiki/View.aspx?title=Enhanced%20Blog%20Edition&amp;referringTitle=Home">SharePoint blog and wiki plugins</a> I can harness to increase the functionality.</p>
<p>SharePoint interfaces can be radically modified, so I&#8217;ll be exploring SharePoint Designer to see just how easy that is. However, one thing Stewart said has really stuck with me:</p>
<blockquote><p>Content is what matters most.</p></blockquote>
<p>The wiki doesn&#8217;t have to look like a professional website to serve its purpose. As long as the content is accurate and relevant, users will benefit &#8212; even if the interface is simple.</p>
<p>Did I have any other conference epiphanies? Not really, but I&#8217;ll leave you with a small growing idea that I secretly enjoy even without hard evidence — <em>bloggers are cool people</em>. <a href="http://darrenbarefoot.com">Darren Barefoot</a>, a prominent blogger, delivered a keynote and participated on the <a href="http://www.doctrain.com/west/program_detail/meet_the_bloggers/">Meet the Bloggers</a> panel. Although I only spoke briefly with him, he seemed like a cool person, as did other bloggers I met at the conference (such as <a href="http://justwriteclick.com/">Anne Gentle</a>, who organized an <a href="http://justwriteclick.com/2008/05/10/doctrain-west-2008-how-was-the-unconference/">Unconference</a>, and <a href="http://scriptorium.com/palimpsest/">Sara O&#8217;Keefe</a>, who was doing some impressive live blogging).</p>
<p>Dare I say that bloggers are more engaged, passionate, commonsensical people? Anyone who is engaged enough with a topic to write constantly about it usually ends up being a fun person to listen to. Their passion drives them.</p>
<p>&#8212;-</p>
<p>airplane photo from <a href="http://flickr.com/photos/ecstaticist/228015304/sizes/l/">ecstaticist</a></p>
]]></content:encoded>
			<wfw:commentRss>http://idratherbewriting.com/2008/05/12/post-doc-train-thoughts-sitting-in-the-vancouver-airport/feed/</wfw:commentRss>
		<slash:comments>15</slash:comments>
		</item>
	</channel>
</rss>

