<?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; WritersUA</title>
	<atom:link href="http://idratherbewriting.com/tag/writersua/feed/" rel="self" type="application/rss+xml" />
	<link>http://idratherbewriting.com</link>
	<description>The Latest Trends in Technical Communication</description>
	<lastBuildDate>Fri, 10 Feb 2012 23:59:59 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.3.1</generator>
		<item>
		<title>What Tools Do Technical Writers Use</title>
		<link>http://idratherbewriting.com/2011/12/19/what-tools-do-technical-writers-use/</link>
		<comments>http://idratherbewriting.com/2011/12/19/what-tools-do-technical-writers-use/#comments</comments>
		<pubDate>Mon, 19 Dec 2011 16:33:14 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[blog]]></category>
		<category><![CDATA[Flare]]></category>
		<category><![CDATA[Technical Writing]]></category>
		<category><![CDATA[tools]]></category>
		<category><![CDATA[WritersUA]]></category>

		<guid isPermaLink="false">http://idratherbewriting.com/?p=10148</guid>
		<description><![CDATA[Students and others trying to break into technical writing are always wondering what tools they should use. The latest tools survey from WritersUA seems helpful in answering this question. The survey concludes that some of the most popular tools for technical writers are Adobe Acrobat, Camtasia Studio, Adobe Captivate, Dreamweaver, Madcap Flare, Framemaker, Photoshop, Robohelp, Snagit, and Visio. Of these tools, Flare scores highest as ... <a href="http://idratherbewriting.com/2011/12/19/what-tools-do-technical-writers-use/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<p><a href="http://idratherbewriting.com/wp-content/uploads/2011/12/tools.png"><img class="alignright size-thumbnail wp-image-10206" title="What Tools Do Technical Writers Use?" src="http://idratherbewriting.com/wp-content/uploads/2011/12/tools-150x150.png" alt="What Tools Do Technical Writers Use?" width="150" height="150" /></a>Students and others trying to break into technical writing are always wondering what tools they should use. The latest <a title="tools for technical writers" href="http://www.writersua.com/surveys/tools12/index.html">tools survey from WritersUA</a> seems helpful in answering this question.</p>
<p>The survey concludes that some of the most popular tools for technical writers are Adobe Acrobat, Camtasia Studio, Adobe Captivate, Dreamweaver, Madcap Flare, Framemaker, Photoshop, Robohelp, Snagit, and Visio.</p>
<p>Of these tools, Flare scores highest as a tool that participants can&#8217;t live without. They ranked it as a 5, meaning &#8220;very important.&#8221; Presumably this is because Flare does an excellent job in single sourcing to other formats, such as print and mobile. It&#8217;s an all-in-one solution, so it by definition it&#8217;s important or you&#8217;re not using the tool correctly.</p>
<p>The WritersUA survey is a little frustrating because these tools aren&#8217;t grouped by category. Some are screen capture tools, others are PDF conversion tools, others are image editing tools, others are video recording tools. I use Photoshop and Snagit, but ranking these along with Robohelp and Flare is to compare apples to oranges. Similarly, Camtasia Studio and Captivate are in another category. It would be helpful to sort the tools by category. (Still, it&#8217;s nice to see someone doing a tools survey in the first place.)</p>
<p>Of the help authoring tools, it&#8217;s interesting to see Flare rank so high. Flare is an excellent help authoring tool, and with a knowledge of CSS you can completely customize the webhelp and print output to look professional. However, its main failure is the lack of collaborative authoring. If you have 15 writers all contributing to the same help project, you have to import the content from other authors. They can use supporting tools such as Madcap Contribute, or Word templates. You can also try hosting Flare on SharePoint and enabling collaboration this way.</p>
<p>But I&#8217;m guessing that Flare is popular because most technical writers are solo sailors on their own ship, without the need for collaboration from other writers. In my career, the number of collaborative projects has been very small. I am usually the only writer for the project, which means collaborative authoring is unimportant. I don&#8217;t need a central repository installed on a server that numerous authors can access and pull content from. Content is also not reused between projects, since each documentation project covers a different product.</p>
<p>Sarah O&#8217;Keefe also has some comments on the WritersUA tools survey. See her post, <a title="The passion quotient" href="http://www.scriptorium.com/2011/12/the-passion-quotient/">The passion quotient</a>. She notes that the survey highlights &#8220;the tool for which the importance is ranked the highest.&#8221; Despite this criteria in evaluation, I am not sure how I would design the tools survey differently.<br />
<h2>Blog Sponsors</h2>
<ul>
<li><a href="http://webworks.com">Webworks ePublisher</a></li>
<li><a href="http://scriptorium.com">Scriptorium</a></li>
<li><a href="http://www.helpgenerator.com">Help Generator help authoring software</a></li>
<li><a href="http://idc.spsu.edu">Southern Polytechnic: Information Design and Communication</a></li>
<li><a href="http://simplifiedenglish.net">Simplified English</a></li>
<li><a href="http://info.mindtouch.com/irbw/tcs-custom-tour?persona=content">MindTouch</a></li>
<li><a href="http://www.madcapsoftware.com/products/madpak/overview.aspx?utm_source=IdRatherBeWriting&#038;utm_medium=Banner&#038;utm_campaign=MadPak"</a>Madcap Software</a></li>
<li><a href="http://www.drexplain.com/">Dr.Explain</a> </li>
<li><a href="http://www.adobe.com/products/technicalcommunicationsuite/try.html?sdid=ITRSO">Adobe Technical Communication Suite</a></li>
<li><a href="http://www.congree.com/en/download-congree-personal-edition.aspx">Congree</a></li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://idratherbewriting.com/2011/12/19/what-tools-do-technical-writers-use/feed/</wfw:commentRss>
		<slash:comments>11</slash:comments>
		</item>
		<item>
		<title>Book Review: Developing User Assistance for Mobile Apps, by Joe Welinske</title>
		<link>http://idratherbewriting.com/2011/08/02/book-review-developing-user-assistance-for-mobile-apps/</link>
		<comments>http://idratherbewriting.com/2011/08/02/book-review-developing-user-assistance-for-mobile-apps/#comments</comments>
		<pubDate>Tue, 02 Aug 2011 17:18:36 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[android]]></category>
		<category><![CDATA[book reviews]]></category>
		<category><![CDATA[Developing User Assistance for Mobile Apps]]></category>
		<category><![CDATA[iOS]]></category>
		<category><![CDATA[Joe Welinske]]></category>
		<category><![CDATA[mobile]]></category>
		<category><![CDATA[smartphones]]></category>
		<category><![CDATA[tablets]]></category>
		<category><![CDATA[windows]]></category>
		<category><![CDATA[WritersUA]]></category>

		<guid isPermaLink="false">http://idratherbewriting.com/?p=9618</guid>
		<description><![CDATA[Joe Welinske&#8217;s latest book, Developing User Assistance for Mobile Apps (published June 2011), fills a gap in tech comm literature that is sorely needed. Joe explores strategies and techniques for providing user assistance for mobile devices, and goes in depth with iOS, Android, Windows, and tablets. Early in the book, he explains: Hopefully the organizations that employ us will start buying smartphone devices for us ... <a href="http://idratherbewriting.com/2011/08/02/book-review-developing-user-assistance-for-mobile-apps/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<p><a href="http://www.writersua.com/mobile/book.htm"><img class="size-full wp-image-9622  alignright" style="border: none;" title="Developing Mobile User Assistance, by Joe Welinske" src="http://idratherbewriting.com/wp-content/uploads/2011/08/mobile_user_assistance.png" alt="Developing Mobile User Assistance, by Joe Welinske" width="180" height="272" /></a>Joe Welinske&#8217;s latest book, <em><a href="http://www.writersua.com/mobile/book.htm">Developing User Assistance for Mobile Apps</a></em> (published June 2011), fills a gap in tech comm literature that is sorely needed. Joe explores strategies and techniques for providing user assistance for mobile devices, and goes in depth with iOS, Android, Windows, and tablets.</p>
<p>Early in the book, he explains:</p>
<blockquote><p>Hopefully the organizations that employ us will start buying smartphone devices for us to work with just as they provide us with desktop workstations (13).</p></blockquote>
<p>It would be odd to be an IT employee in a company without being provisioned a computer. Now that mobile is becoming more common, shouldn&#8217;t we also be provisioned a mobile device too, if not several?</p>
<p>One of my colleagues just recently purchased his first smartphone. He decided to buy it himself rather than asking our organization to pay for it. Usually only employees with special needs to be reached outside of work times receive smartphones.</p>
<p>But the world has changed. We know that mobile is quickly becoming the most common way for people across the world to access the Internet. It&#8217;s much more common to consider and plan mobile development at the same time that you&#8217;re building a browser-based application. Mobile is no longer an afterthought. It should be part of our regular workflow, strategy, and deliverables &#8212; not just for developers, but for technical writers too.</p>
<p>Given the need to add user assistance deliverables to mobile, where do you start? Almost every mobile device has an emulator or simulator that allows you to explore the functionality from another computer. You also need the right software and setup. For most of us, this is a new world with unfamiliar terrain. How do you connect, how do you test, what software do you need, how do you publish, and how does it all vary by device? Joe covers all of this in depth for the major mobile platforms.</p>
<p>Additionally, he explores techniques for integrating help into mobile apps. Brevity and user testing are guiding principles. But as for a standard, &#8220;the look and feel of the UA is as varied as the apps themselves&#8221; (19). You can use everything from Dashcode (a mobile help authoring tool), to text built-in to the app, a standalone webpage, or many other solutions.</p>
<p>As for mobile help formats, I was also pleased to read the following advice for mobile documentation:</p>
<blockquote><p>Many support situations can benefit from a richer level of presentation to the user. Videos and demos can provide a more engaging experience. The audio/visual capabilities of video make it a great choice for showing complex tasks and helping the viewer feel at ease. Demonstrations are useful for presenting an automated tutorial about tasks and procedures (28).</p></blockquote>
<p>Yes, even on a mobile device, videos and other rich presentations have a place.  When you consider the advanced interactions with mobile devices &#8212; the gestures, the pinches and squeezes, the flicks and two-finger scroll, the back swipe, etc., you need to see some of these gestures in action to understand.</p>
<p>Undoubtedly, the diversity of mobile devices makes documentation tricky. Joe says the &#8220;wildly different UIs that we find in our apps mean that users can&#8217;t necessarily carry conventions from one app to another. Unique icons, buttons, and menu structures can create angst for users&#8221; (41).</p>
<p>The operating systems and hardware buttons vary from the iPhone, Android, Windows, and tablets. Android itself has many different devices, with different buttons across the bottom. Not only do the operating systems vary, so do the built-in browsers. You need to test your output in all of these devices.</p>
<p>Add to this mix some difficulty in describing finger/touch movements (are these in your style guide?) and how those gesture words might translate, and you have a real challenge. What may have seemed simple suddenly becomes a full-blown documentation challenge.</p>
<p>Joe&#8217;s book is an excellent guide to get started in the world of mobile user assistance. The book is brief (142 pages) but thorough enough to get you comfortable in this space.</p>
<p>To learn more or buy the book, see <a title="Developing User Assistance for Mobile apps" href="http://www.writersua.com/mobile/book.htm">Developing User Assistance for Mobile Apps</a>.<br />
<h2>Blog Sponsors</h2>
<ul>
<li><a href="http://webworks.com">Webworks ePublisher</a></li>
<li><a href="http://scriptorium.com">Scriptorium</a></li>
<li><a href="http://www.helpgenerator.com">Help Generator help authoring software</a></li>
<li><a href="http://idc.spsu.edu">Southern Polytechnic: Information Design and Communication</a></li>
<li><a href="http://simplifiedenglish.net">Simplified English</a></li>
<li><a href="http://info.mindtouch.com/irbw/tcs-custom-tour?persona=content">MindTouch</a></li>
<li><a href="http://www.madcapsoftware.com/products/madpak/overview.aspx?utm_source=IdRatherBeWriting&#038;utm_medium=Banner&#038;utm_campaign=MadPak"</a>Madcap Software</a></li>
<li><a href="http://www.drexplain.com/">Dr.Explain</a> </li>
<li><a href="http://www.adobe.com/products/technicalcommunicationsuite/try.html?sdid=ITRSO">Adobe Technical Communication Suite</a></li>
<li><a href="http://www.congree.com/en/download-congree-personal-edition.aspx">Congree</a></li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://idratherbewriting.com/2011/08/02/book-review-developing-user-assistance-for-mobile-apps/feed/</wfw:commentRss>
		<slash:comments>9</slash:comments>
		</item>
		<item>
		<title>Lots of Conferences Taking Place</title>
		<link>http://idratherbewriting.com/2011/03/04/lots-of-conferences-taking-place/</link>
		<comments>http://idratherbewriting.com/2011/03/04/lots-of-conferences-taking-place/#comments</comments>
		<pubDate>Fri, 04 Mar 2011 15:26:15 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[blog]]></category>
		<category><![CDATA[confab]]></category>
		<category><![CDATA[congility]]></category>
		<category><![CDATA[contentstrategy]]></category>
		<category><![CDATA[iasummit]]></category>
		<category><![CDATA[SXSW]]></category>
		<category><![CDATA[Technical Writing]]></category>
		<category><![CDATA[web content 2011]]></category>
		<category><![CDATA[WritersUA]]></category>

		<guid isPermaLink="false">http://idratherbewriting.com/?p=8706</guid>
		<description><![CDATA[Have you noticed how many good conferences are scheduled lately? I remember a couple of years ago, when Doc Train conferences ended, and some of us thought the STC Summit was approaching its last time &#8212; I thought conferences would become extinct. Today there are almost too many conferences. Here are some of the interesting looking conferences taking place within the next couple of months: ... <a href="http://idratherbewriting.com/2011/03/04/lots-of-conferences-taking-place/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<div id="attachment_8723" class="wp-caption alignright" style="width: 250px"><a href="http://idratherbewriting.com/wp-content/uploads/2011/03/tomandben.jpg"><img class="size-full wp-image-8723" title="Ben Minson and me at the last STC Summit" src="http://idratherbewriting.com/wp-content/uploads/2011/03/tomandben.jpg" alt="Ben Minson and me at the last STC Summit" width="240" height="156" /></a><p class="wp-caption-text">Ben Minson and me at the last STC Summit</p></div>
<p>Have you noticed how many good conferences are scheduled lately? I remember a couple of years ago, when Doc Train conferences ended, and some of us thought the STC Summit was approaching its last time &#8212; I thought conferences would become extinct. Today there are almost too many conferences. Here are some of the interesting looking conferences taking place within the next couple of months:</p>
<ul>
<li><a title="SXSW Interactive" href="http://sxsw.com/interactive">SXSW Interactive </a>&#8211; March 11-15, Austin, Tex.</li>
<li><a title="WritersUA Conference" href="http://www.writersua.com/conference/">WritersUA</a> &#8212; March 13-16, Long Beach, Calif.</li>
<li><a title="Information Architecture Summit" href="http://2011.iasummit.org/">IA Summit </a>&#8211; March 30 &#8211; April 3, Denver, Colo.</li>
<li><a title="Confab Content Strategy Conference 2011" href="http://confab2011.com/">Confab (Content Strategy) </a>&#8211; May 9-11, Minneapolis, Minn.</li>
<li><a title="STC Summit" href="http://summit.stc.org">STC Summit</a> &#8212; May 15-18, Sacramento, Calif.</li>
<li><a title="Congility (formerly X-Pubs)" href="http://www.congility.com/">Congility</a> &#8212; May 24-26, Gatwick, UK</li>
<li><a title="Web Content 2011" href="http://www.webcontent2011.com/">Web Content 2011</a> &#8212; June 6-7, Chicago, Ill.</li>
</ul>
<p>Last month the <a title="Intelligent Content" href="http://www.rockley.com/IC2011/">Intelligent Content</a> conference took place. It seems that the number of conferences are growing. The only conference I&#8217;m planning to attend during the next three months, however, is the STC Summit. But that&#8217;s only due to time and budget. The Content Strategy conference actually looks really appealing.</p>
<p>&#8212;&#8212;&#8212;</p>
<p style="font-size:11px; font-style:italic; font-color: gray">Photo courtesy of <a href="http://www.flickr.com/photos/stc_office/4601558613/sizes/s/in/set-72157623923851467/">STC on Flickr</a></p>
<p>
<h2>Blog Sponsors</h2>
<ul>
<li><a href="http://webworks.com">Webworks ePublisher</a></li>
<li><a href="http://scriptorium.com">Scriptorium</a></li>
<li><a href="http://www.helpgenerator.com">Help Generator help authoring software</a></li>
<li><a href="http://idc.spsu.edu">Southern Polytechnic: Information Design and Communication</a></li>
<li><a href="http://simplifiedenglish.net">Simplified English</a></li>
<li><a href="http://info.mindtouch.com/irbw/tcs-custom-tour?persona=content">MindTouch</a></li>
<li><a href="http://www.madcapsoftware.com/products/madpak/overview.aspx?utm_source=IdRatherBeWriting&#038;utm_medium=Banner&#038;utm_campaign=MadPak"</a>Madcap Software</a></li>
<li><a href="http://www.drexplain.com/">Dr.Explain</a> </li>
<li><a href="http://www.adobe.com/products/technicalcommunicationsuite/try.html?sdid=ITRSO">Adobe Technical Communication Suite</a></li>
<li><a href="http://www.congree.com/en/download-congree-personal-edition.aspx">Congree</a></li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://idratherbewriting.com/2011/03/04/lots-of-conferences-taking-place/feed/</wfw:commentRss>
		<slash:comments>11</slash:comments>
		</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://webworks.com">Webworks ePublisher</a></li>
<li><a href="http://scriptorium.com">Scriptorium</a></li>
<li><a href="http://www.helpgenerator.com">Help Generator help authoring software</a></li>
<li><a href="http://idc.spsu.edu">Southern Polytechnic: Information Design and Communication</a></li>
<li><a href="http://simplifiedenglish.net">Simplified English</a></li>
<li><a href="http://info.mindtouch.com/irbw/tcs-custom-tour?persona=content">MindTouch</a></li>
<li><a href="http://www.madcapsoftware.com/products/madpak/overview.aspx?utm_source=IdRatherBeWriting&#038;utm_medium=Banner&#038;utm_campaign=MadPak"</a>Madcap Software</a></li>
<li><a href="http://www.drexplain.com/">Dr.Explain</a> </li>
<li><a href="http://www.adobe.com/products/technicalcommunicationsuite/try.html?sdid=ITRSO">Adobe Technical Communication Suite</a></li>
<li><a href="http://www.congree.com/en/download-congree-personal-edition.aspx">Congree</a></li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://idratherbewriting.com/2010/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>WritersUA &#8211; The WritersUA Tools Survey &#8211; Tools</title>
		<link>http://idratherbewriting.com/2009/02/27/writersua-the-writersua-tools-survey-tools/</link>
		<comments>http://idratherbewriting.com/2009/02/27/writersua-the-writersua-tools-survey-tools/#comments</comments>
		<pubDate>Fri, 27 Feb 2009 17:32:30 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[Flare]]></category>
		<category><![CDATA[Notes]]></category>
		<category><![CDATA[RoboHelp]]></category>
		<category><![CDATA[surveys]]></category>
		<category><![CDATA[tools]]></category>
		<category><![CDATA[WritersUA]]></category>

		<guid isPermaLink="false">http://writerriver.com/?p=827</guid>
		<description><![CDATA[WritersUA &#8211; The WritersUA Tools Survey &#8211; Tools. Blog Sponsors Webworks ePublisher Scriptorium Help Generator help authoring software Southern Polytechnic: Information Design and Communication Simplified English MindTouch]]></description>
			<content:encoded><![CDATA[<p><a href="http://www.writersua.com/surveys/tools09/index.html">WritersUA &#8211; The WritersUA Tools Survey &#8211; Tools</a>.<br />
<h2>Blog Sponsors</h2>
<ul>
<li><a href="http://webworks.com">Webworks ePublisher</a></li>
<li><a href="http://scriptorium.com">Scriptorium</a></li>
<li><a href="http://www.helpgenerator.com">Help Generator help authoring software</a></li>
<li><a href="http://idc.spsu.edu">Southern Polytechnic: Information Design and Communication</a></li>
<li><a href="http://simplifiedenglish.net">Simplified English</a></li>
<li><a href="http://info.mindtouch.com/irbw/tcs-custom-tour?persona=content">MindTouch</a></li>
<li><a href="http://www.madcapsoftware.com/products/madpak/overview.aspx?utm_source=IdRatherBeWriting&#038;utm_medium=Banner&#038;utm_campaign=MadPak"</a>Madcap Software</a></li>
<li><a href="http://www.drexplain.com/">Dr.Explain</a> </li>
<li><a href="http://www.adobe.com/products/technicalcommunicationsuite/try.html?sdid=ITRSO">Adobe Technical Communication Suite</a></li>
<li><a href="http://www.congree.com/en/download-congree-personal-edition.aspx">Congree</a></li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://idratherbewriting.com/2009/02/27/writersua-the-writersua-tools-survey-tools/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Top Technical Communication News for January 2009</title>
		<link>http://idratherbewriting.com/2009/01/11/top-technical-communication-news-for-january-2009/</link>
		<comments>http://idratherbewriting.com/2009/01/11/top-technical-communication-news-for-january-2009/#comments</comments>
		<pubDate>Mon, 12 Jan 2009 05:29:44 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[Podcasts]]></category>
		<category><![CDATA[Camtasia Studio]]></category>
		<category><![CDATA[cherryleaf]]></category>
		<category><![CDATA[doc-to-help]]></category>
		<category><![CDATA[i'm a tech writer]]></category>
		<category><![CDATA[Jing]]></category>
		<category><![CDATA[salary survey]]></category>
		<category><![CDATA[STC]]></category>
		<category><![CDATA[techcomm toolbox]]></category>
		<category><![CDATA[tools survey]]></category>
		<category><![CDATA[Twitter]]></category>
		<category><![CDATA[wordpress 2.7]]></category>
		<category><![CDATA[WritersUA]]></category>

		<guid isPermaLink="false">http://www.idratherbewriting.com/?p=2636</guid>
		<description><![CDATA[Download MP3 (to download, right-click and select Save Target As) Length: 12 min. In this podcast, I cover the top 10 technical communication news items during the past month. This is a different type of podcast than I&#8217;ve normally done. The show notes below are excerpts of what I cover, but without any commentary. 1. Techcomm toolbox One of the most common questions heard on ... <a href="http://idratherbewriting.com/2009/01/11/top-technical-communication-news-for-january-2009/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<p><a title="Top 10 Tech Comm News for January 2009" href="http://www.podtrac.com/pts/redirect.mp3?http://idratherbewriting.com/podcasts/top10_jan09.mp3"></a></p>
<p><a title="Top 10 Tech Comm News for January 2009" href="http://www.podtrac.com/pts/redirect.mp3?http://idratherbewriting.com/podcasts/top10_jan09.mp3">Download MP3</a> (to download, right-click and select Save Target As)<br />
Length: 12 min.</p>
<p>In this podcast, I cover the top 10 technical communication news items during the past month. This is a different type of podcast than I&#8217;ve normally done. The show notes below are excerpts of what I cover, but without any commentary. <span id="more-2636"></span></p>
<p><a href="techcommtoolbox.com">1. Techcomm toolbox</a></p>
<blockquote><p>One of the most common questions heard on many forums is “What tool do you use for [purpose]?” Answers vary, of course, because everyone has their own favorites and some folks will even answer that the right tool is “the one that best meets your needs”.</p>
<p>Sometimes, many people will answer that you need to look at the different tools, download trial versions, and test. But where is the list of tools to choose from?</p>
<p>It’s here at TechComm Toolbox, your online resource for all applications, services, consultantsm, and trainers related to technical communication.</p></blockquote>
<p><a href="http://www.mardahl.dk/2009/01/11/im-tweeting/  ">2. Emergence of STC groups on twitter</a></p>
<blockquote><p>More and more STC groups are joining and participating on Twitter: <a href="http://twitter.com/stcaccess">stcaccess</a>, <a href="http://twitter.com/stcchicago">stcchicago</a>, <a href="http://twitter.com/stchouston">stchouston</a>, <a href="http://twitter.com/stcboston">stcboston</a>, <a href="http://twitter.com/stcintermtn">stcintermtn</a>. Also, Writer River now has a Twitter feed: <a href="http://twitter.com/writerriver">writerriver</a>.</p></blockquote>
<p><a href="http://writersua.com" target="_blank">3. WritersUA Salary survey and tools survey going on</a></p>
<blockquote><p>The WritersUA Tools Survey is underway. The survey is designed to provide our community with a guide to the relative popularity and satisfaction of a number of tools. &#8230; The Salary Survey provides a look at the various factors that contribute to higher salaries in the software user assistance community.</p></blockquote>
<p><a href="http://blog.jingproject.com/2009/01/like-jing-youll-love-jing-pro.html">4. Jing Pro Released</a></p>
<blockquote><p>Jing Pro brings you simply the best-in-class experience for quick visual online conversation. Imagine everything you already know and love about Jing, then add:</p>
<p>* HD quality video for the web<br />
* Direct output to YouTube<br />
* No more branding on the end of your videos.</p></blockquote>
<p><a href="imatechwriter.com " target="_blank">5. I&#8217;m a tech writer photo gallery </a></p>
<blockquote><p>Technical Writers (aka Technical Authors, Content Wranglers and Documentation Managers) have an unfair image. This project aims to challenge this image, by showing technical writers in a different light. The photos below are of technical communications professionals, doing a variety of activities.If you are involved in technical writing and you&#8217;d like to be included, contact us and send us a photo, together with your name and location.</p></blockquote>
<p><a href="http://conference.stc.org/">6. STC to record and make available the entire Summit</a></p>
<blockquote><p>Beginning this year at the Summit in Atlanta, STC will capture the content (audio and visuals) of almost every session and make it available to attendees at no additional cost. This will increase the value of your experience tenfold. After the conference, STC will sync the audio with the presentations and make them available (by passcode) for attendees on the STC website. This will allow [you] to “attend” all those sessions [you] missed. It will also allow [you] to revisit the ones that [you] did attend and to refresh [your] memory of the fine points made by the speakers. (From Mark Clifford&#8217;s January <em>News and Notes</em>)</p></blockquote>
<p><a href="http://wordpress.org/development/2008/12/coltrane/">7. WordPress 2.7 released.</a></p>
<blockquote><p>This may be the last time you ever have to manually upgrade WordPress again. We heard how tired you were of doing upgrades for yourself and your friends, so now WordPress includes a built-in upgrade that will automatically notify you of new releases, and when you’re ready it will download them, install them, and upgrade your blog with a single click. [Also, <a href="http://buddypress.com">BuddyPress</a> is in beta: "BuddyPress is a set of WordPress MU specific plugins, each plugin adding a distinct new feature. BuddyPress contains all the features you’d expect from WordPress but aims to let members socially interact."]</p></blockquote>
<p><a href="http://tech-writing.alltop.com/">8. Alltop publishes Tech Writing category</a></p>
<blockquote><p>Alltop is an “online magazine rack” of popular topics. We update the stories every hour. Pick a topic by searching, news category, or name, and we’ll deliver it to you 24 x 7. All the topics, all the time.</p></blockquote>
<p><a href="http://www.techsmith.com/camtasia/whatsnew.asp">9. Camtasia 6 released</a></p>
<blockquote><p>When recording audio and video at the same time, it&#8217;s hard to be perfect. So we&#8217;ve made it easier to fix mistakes. Simply decouple the audio and video tracks to edit them independently. And move audio clips between (and along) tracks to line everything up perfectly. Bottom line: fewer retakes and less time spent on editing.</p></blockquote>
<p><a href="http://www.componentone.com/SuperProducts/DocToHelp/What%27s+New/">10. Doc to help releases 2009 version, with ribbon-based interface</a></p>
<blockquote><p>What&#8217;s new: built-in xml based editor, dynamic help control for embedding help in .net applications. xhtml converter, drag and drop linking, and abbility to import project settings.</p></blockquote>
<p>
<h2>Blog Sponsors</h2>
<ul>
<li><a href="http://webworks.com">Webworks ePublisher</a></li>
<li><a href="http://scriptorium.com">Scriptorium</a></li>
<li><a href="http://www.helpgenerator.com">Help Generator help authoring software</a></li>
<li><a href="http://idc.spsu.edu">Southern Polytechnic: Information Design and Communication</a></li>
<li><a href="http://simplifiedenglish.net">Simplified English</a></li>
<li><a href="http://info.mindtouch.com/irbw/tcs-custom-tour?persona=content">MindTouch</a></li>
<li><a href="http://www.madcapsoftware.com/products/madpak/overview.aspx?utm_source=IdRatherBeWriting&#038;utm_medium=Banner&#038;utm_campaign=MadPak"</a>Madcap Software</a></li>
<li><a href="http://www.drexplain.com/">Dr.Explain</a> </li>
<li><a href="http://www.adobe.com/products/technicalcommunicationsuite/try.html?sdid=ITRSO">Adobe Technical Communication Suite</a></li>
<li><a href="http://www.congree.com/en/download-congree-personal-edition.aspx">Congree</a></li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://idratherbewriting.com/2009/01/11/top-technical-communication-news-for-january-2009/feed/</wfw:commentRss>
		<slash:comments>7</slash:comments>
<enclosure url="http://www.podtrac.com/pts/redirect.mp3?http://idratherbewriting.com/podcasts/top10_jan09.mp3" length="11649152" type="audio/mpeg" />
		</item>
		<item>
		<title>WritersUA Salary Survey, Tools Survey, and Upcoming Conference</title>
		<link>http://idratherbewriting.com/2009/01/10/writersua-salary-survey-tools-survey-and-upcoming-conference/</link>
		<comments>http://idratherbewriting.com/2009/01/10/writersua-salary-survey-tools-survey-and-upcoming-conference/#comments</comments>
		<pubDate>Sun, 11 Jan 2009 06:54:34 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[blog]]></category>
		<category><![CDATA[conference]]></category>
		<category><![CDATA[Linkedin]]></category>
		<category><![CDATA[salary survey]]></category>
		<category><![CDATA[Technical Writing]]></category>
		<category><![CDATA[tools survey]]></category>
		<category><![CDATA[WritersUA]]></category>

		<guid isPermaLink="false">http://www.idratherbewriting.com/?p=2631</guid>
		<description><![CDATA[WritersUA has their annual salary and tools surveys going on. Their survey results are among the most influential of surveys, so be sure to participate. Click the following links to take the surveys: WritersUA Tools Survey WritersUA Salary Survey Additionally, WritersUA has a conference coming up at the end of March. Although I&#8217;ve never been, everyone I&#8217;ve met who has attended has praised the conference. ... <a href="http://idratherbewriting.com/2009/01/10/writersua-salary-survey-tools-survey-and-upcoming-conference/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<p><a href="http://writersua.com">WritersUA</a> has their annual salary and tools surveys going on. Their survey results are among the most influential of surveys, so be sure to participate. Click the following links to take the surveys:</p>
<ul>
<li><a href="http://www.surveymonkey.com/s.aspx?sm=KDOoo9adavxGoTUAk8I_2big_3d_3d">WritersUA Tools Survey</a></li>
<li><a href="http://www.surveymonkey.com/s.aspx?sm=HnpFYeLPceTBbPKCPbVyMA_3d_3d">WritersUA Salary Survey</a></li>
</ul>
<p>Additionally, WritersUA has a <a href="http://www.writersua.com/ohc/index.html">conference coming up</a> at the end of March. Although I&#8217;ve never been, everyone I&#8217;ve met who has attended has praised the conference. As if this all weren&#8217;t enough, they also have a <a href="http://www.linkedin.com/groups?gid=1276817&amp;trk=hb_side_g">WritersUA Linkedin group</a>.</p>
<p><div id="attachment_2632" class="wp-caption aligncenter" style="width: 410px"><a href="http://www.writersua.com/ohc/index.html"><img class="size-medium wp-image-2632" title="WritersUA Conference" src="http://www.idratherbewriting.com/wp-content/uploads/2009/01/writersuu_conference-400x214.png" alt="WritersUA Conference" width="400" height="214" /></a><p class="wp-caption-text">WritersUA Conference</p></div><br />
<h2>Blog Sponsors</h2>
<ul>
<li><a href="http://webworks.com">Webworks ePublisher</a></li>
<li><a href="http://scriptorium.com">Scriptorium</a></li>
<li><a href="http://www.helpgenerator.com">Help Generator help authoring software</a></li>
<li><a href="http://idc.spsu.edu">Southern Polytechnic: Information Design and Communication</a></li>
<li><a href="http://simplifiedenglish.net">Simplified English</a></li>
<li><a href="http://info.mindtouch.com/irbw/tcs-custom-tour?persona=content">MindTouch</a></li>
<li><a href="http://www.madcapsoftware.com/products/madpak/overview.aspx?utm_source=IdRatherBeWriting&#038;utm_medium=Banner&#038;utm_campaign=MadPak"</a>Madcap Software</a></li>
<li><a href="http://www.drexplain.com/">Dr.Explain</a> </li>
<li><a href="http://www.adobe.com/products/technicalcommunicationsuite/try.html?sdid=ITRSO">Adobe Technical Communication Suite</a></li>
<li><a href="http://www.congree.com/en/download-congree-personal-edition.aspx">Congree</a></li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://idratherbewriting.com/2009/01/10/writersua-salary-survey-tools-survey-and-upcoming-conference/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>The WritersUA Salary Survey</title>
		<link>http://idratherbewriting.com/2009/01/09/the-writersua-salary-survey/</link>
		<comments>http://idratherbewriting.com/2009/01/09/the-writersua-salary-survey/#comments</comments>
		<pubDate>Sat, 10 Jan 2009 04:39:50 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[Notes]]></category>
		<category><![CDATA[salary]]></category>
		<category><![CDATA[survey]]></category>
		<category><![CDATA[WritersUA]]></category>

		<guid isPermaLink="false">http://writerriver.com/2009/01/09/the-writersua-salary-survey/</guid>
		<description><![CDATA[The WritersUA Salary Survey Blog Sponsors Webworks ePublisher Scriptorium Help Generator help authoring software Southern Polytechnic: Information Design and Communication Simplified English MindTouch]]></description>
			<content:encoded><![CDATA[<p><a href="http://www.surveymonkey.com/s.aspx?sm=HnpFYeLPceTBbPKCPbVyMA_3d_3d">The WritersUA Salary Survey</a><br />
<h2>Blog Sponsors</h2>
<ul>
<li><a href="http://webworks.com">Webworks ePublisher</a></li>
<li><a href="http://scriptorium.com">Scriptorium</a></li>
<li><a href="http://www.helpgenerator.com">Help Generator help authoring software</a></li>
<li><a href="http://idc.spsu.edu">Southern Polytechnic: Information Design and Communication</a></li>
<li><a href="http://simplifiedenglish.net">Simplified English</a></li>
<li><a href="http://info.mindtouch.com/irbw/tcs-custom-tour?persona=content">MindTouch</a></li>
<li><a href="http://www.madcapsoftware.com/products/madpak/overview.aspx?utm_source=IdRatherBeWriting&#038;utm_medium=Banner&#038;utm_campaign=MadPak"</a>Madcap Software</a></li>
<li><a href="http://www.drexplain.com/">Dr.Explain</a> </li>
<li><a href="http://www.adobe.com/products/technicalcommunicationsuite/try.html?sdid=ITRSO">Adobe Technical Communication Suite</a></li>
<li><a href="http://www.congree.com/en/download-congree-personal-edition.aspx">Congree</a></li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://idratherbewriting.com/2009/01/09/the-writersua-salary-survey/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Technical Writing &#8212; Worth it? Interesting? Creative? Well-Paid? Hours? Answering a Few Questions from Saudi Arabia</title>
		<link>http://idratherbewriting.com/2008/04/09/a-few-questions-from-saudi-arabia-about-technical-writing/</link>
		<comments>http://idratherbewriting.com/2008/04/09/a-few-questions-from-saudi-arabia-about-technical-writing/#comments</comments>
		<pubDate>Thu, 10 Apr 2008 06:28:29 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[blog]]></category>
		<category><![CDATA[career satisfaction]]></category>
		<category><![CDATA[India]]></category>
		<category><![CDATA[offshoring]]></category>
		<category><![CDATA[outsourcing]]></category>
		<category><![CDATA[salary]]></category>
		<category><![CDATA[Saudi Arabia]]></category>
		<category><![CDATA[Technical Writing]]></category>
		<category><![CDATA[work-life balance]]></category>
		<category><![CDATA[WritersUA]]></category>

		<guid isPermaLink="false">http://www.idratherbewriting.com/?p=1460</guid>
		<description><![CDATA[Kalyani from Saudi Arabia writes, My name is Kalyani. I am 37 yrs old and live in Saudi Arabia. I have finished my Diploma in Electronics (4 year course). I was working at Hewlett Packard in India before moving to Saudi. In this country, women have very few opportunities to work i.e., only in the schools or hospitals. I chose to work in the school ... <a href="http://idratherbewriting.com/2008/04/09/a-few-questions-from-saudi-arabia-about-technical-writing/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<p>Kalyani from Saudi Arabia writes,</p>
<blockquote><p>My name is Kalyani. I am 37 yrs old and live in Saudi Arabia. I have finished my Diploma in Electronics (4 year course). I was working at Hewlett Packard in India before moving to Saudi.</p>
<p>In this country, women have very few opportunities to work i.e., only in the schools or hospitals. I chose to work in the school as an English and Computer Science teacher. Now I have moved into the administration.</p>
<p>After 7 years in this country, I want to move back to India. While looking at the job market, I thought of re-training and getting into &#8220;Technical writing&#8221;. I have a good command over English and a flair for writing. My computer skills are very good.</p>
<p>I have 4 months before I go back to India. I wanted to start my online training from &#8216;The Writers&#8217; Block&#8217;, a training institute in Bangalore, India.</p>
<p>I have a few questions for you: <span id="more-1460"></span></p>
<ol>
<li>Is &#8220;Technical writing&#8221; an interesting career? (I like to be creative and take up challenges)</li>
<li>Can you maintain your work-life balance? (I have 3 boys aged 9, 5 and 3)</li>
<li>Does it pay well?</li>
<li>In the long term, is it worth being a &#8216;technical writer&#8217;?</li>
<li>Do you think online training is a right choice? Or should I take the regular course??</li>
</ol>
<p>I hope you will help me out with my queries whenever you find the time.</p></blockquote>
<blockquote><p>[Me: I asked Kalyani to tell me the state of outsourcing in India.]</p></blockquote>
<blockquote><p>Right now, outsourcing is at a peak in India, especially in Bangalore from where I come. There are many BPOs and there are few technical writers. Unlike software technicians who are in plenty, technical writers are still few in number. I&#8217;ll go for this when the demand is still good.<br />
Most of the European and American companies have outsourced their services in India. So I think this is the time to go for it.</p>
<p>I&#8217;ll look forward to reading your blog post.</p>
<p>Thanks again,</p>
<p>Kalyani</p></blockquote>
<p>Thanks for writing, Kalyani. It&#8217;s always interesting to hear from readers in Saudi Arabia. You have an excellent background for entering the field of technical writing. With a degree in electronics, experience as an English and Computer Science teacher, and work experience at HP, you are probably well suited for a job as a technical writer. Let me try to answer your questions.</p>
<p><strong>1. Is &#8220;Technical writing&#8221; an interesting career? (I like to be creative and take up challenges)</strong></p>
<p>Yes, it is an interesting career. However, you can read some posts and discussions on this site that talk about <a href="http://www.idratherbewriting.com/2007/02/13/is-technical-writing-boring/">whether technical writing is boring</a>. Also read this post that explores <a href="http://www.idratherbewriting.com/2008/04/01/the-question-no-one-asked-me-at-the-career-advice-panel-thank-goodness/">whether I&#8217;d become a technical writer again</a> if starting over from scratch. I recently asked a <a href="http://s-x2vu8-40816.sgizmo.com/">2 question survey</a> to see if my readers felt the same way.</p>
<p>You can <a href="http://app.sgizmo.com/reports/771/29721/A37EB69A139SK735S3ZQ8LJB0U3ETR/">see the results of 16 responses</a> so far. Basically, only 31% of people would definitely become technical writers if starting over. 37% said maybe, and 31% said no.</p>
<p><a href="http://app.sgizmo.com/reports/771/29721/A37EB69A139SK735S3ZQ8LJB0U3ETR/"><img class="alignnone size-full wp-image-1461" title="2" src="http://www.idratherbewriting.com/wp-content/uploads/2008/04/2.png" alt="" width="486" height="287" /></a></p>
<p>The funny thing is, most of those who said no would instead move into instructional design, web design, or usability, which are all somewhat close to technical writing anyway. (By the way, the <a href="http://s-x2vu8-40816.sgizmo.com/">survey</a> is still open.)<br />
Although reading those posts may not put technical writing in a glamorous spotlight, it truly is a solid professional field with a lot of room to grow and explore new technologies. I do enjoy my job as a technical writer.</p>
<p>Technical writers can focus on a variety of things (content management, information architecture, e-learning, usability, single sourcing, XML, DITA, web design, multimedia), but the majority of technical writers spend their days creating help material such as online help, printed manuals, quick reference guides, and writing and formatting other content.</p>
<p>Of course it&#8217;s not riveting, but as jobs go, it&#8217;s not bad. I would say that technical writing is a satisfying career, but not a fulfilling one. (Vague on purpose there.)<strong><br />
</strong><br />
<strong>2. Can you maintain your work-life balance? (I have 3 boys aged 9, 5 and 3)</strong></p>
<p>It depends on your company. Most technical writers I know maintain a very comfortable work-life balance. It&#8217;s nothing like investment banking or law or medicine where you&#8217;re expected to put in 60+ hour weeks as the norm.</p>
<p>I have an 8 to 5 day, and I come home to a home-cooked meal and then wrestle with my kids for a while before putting them to bed and wandering online to post a few entries on my blog. Okay, so it&#8217;s not that idyllic, but the work-life balance is one of the best things about being a technical writer.<strong><br />
</strong><br />
<strong>3. Does it pay well?</strong></p>
<p>Yes, technical writing is probably the most lucrative career in writing apart from being a best-selling novelist or becoming a big-time publisher in New York City. Of the careers one can pursue as a writer &#8212; copywriter, copy editor, proofreader, essayist, journalist, teacher, professor &#8212; technical writers earn a lot more, at least 1/3 more in salary, I&#8217;d say.</p>
<p>For surveys, see the <a href="http://www.winwriters.com/surveys/salary08/index.html">WritersUA 2008 salary survey</a>, which found the average salary of a technical writer in the U.S. to be about 76k a year. Everyone I talk to thinks this number is a little high. In 2006, <a href="http://money.cnn.com/magazines/moneymag/bestjobs/2006/top50/index.html">Money Magazine named technical writing the 13th best job</a> in America and said the average salary was 57K a year.</p>
<p>My own opinion is that the real average salary for technical writers is somewhere between 57 and 76. It depends on where you live, how many years of experience you have, what company you work for, and how good you are at negotiating a salary.<strong><br />
</strong><br />
<strong>4. In the long term, is it worth being a &#8216;technical writer&#8217;?</strong></p>
<p>I assume this question has something to do with intangible rewards, particularly compared to careers in education. As a teacher, one often feels an internal reward in helping students learn and grow and see the world in a new light. (Or so they say.)</p>
<p>Well, the problem with feeling great worth as a technical writer is that we&#8217;re so disconnected with our users. We don&#8217;t watch them use our help. Teachers in the classroom can directly observe the impact of their teaching. But I can&#8217;t see the indescribable joy that comes to those who read my instructions in moments of frustration and suddenly &#8220;get it.&#8221; I can&#8217;t observe users who, after struggling for hours, finally turn to the help and within minutes fall down on their knees and kiss the software manual I wrote, tears falling down their cheeks in gratitude. <img src='http://idratherbewriting.com/wp-includes/images/smilies/icon_smile.gif' alt=':)' class='wp-smiley' /> </p>
<p>I used to be a copywriter writing press releases, web copy, and all kinds of other campaigns to get people to buy nutritional supplements. While I was allowed be more creative as a copywriter, it wasn&#8217;t worth it because I didn&#8217;t believe in the products. In contrast, as a technical writer, I feel that helping people understand complicated technology so they can do their jobs better, become more efficient, and feel more comfortable with software applications is worthwhile.</p>
<p>But &#8220;worth it&#8221; really depends on you. What makes life worth it to you? (Here&#8217;s an article that explores whether <a href="http://www.stc-carolina.org/newsletter/tiki-index.php?page=Pith+and+Vinegar%3A+Is+Technical+Writing+Your+Calling%3F">technical writing is a calling or job</a>.) The sense of worth varies for every person according to their perceived calling and life purpose. Someone gifted in medicine would not feel that writing help content and making video tutorials is &#8220;worth it.&#8221; A job worth it for that person is in the exam room or ER. But for writers, technical writing is an activity much more worthwhile.</p>
<p><strong>5. Do you think online training is a right choice? Or should I take the regular course??</strong></p>
<p>I don&#8217;t know. I learned much of what I know about technical writing from my first job. I learned most of the tools on my own, and picked up style and other techniques by looking at manuals, trying different techniques, and in general reading from various sources. A course could be highly beneficial.<br />
Read this comment by Mike, which he left on a post I wrote called &#8220;<a href="http://www.idratherbewriting.com/2008/03/27/whats-the-best-thing-youve-done-to-grow-your-career/#comment-128325">What&#8217;s the Best Thing You&#8217;ve Done to Grow Your Career?&#8221;:</a></p>
<p>Without a doubt, the best “move” I made in regard to my technical writing career was completing a graduate degree in communication. The sheer number of programs (broad-based professional programs to specialized technical programs) make a graduate degree possible for every practicing technical writer. And the networking opportunities within a graduate program are extremely beneficial.</p>
<p>It&#8217;s never a bad idea to take a course in anything, really. (However, I&#8217;m a little confused by the name of the Institute you mentioned, the &#8220;Writer&#8217;s Block.&#8221; Let&#8217;s hope they teach you how to avoid that.)</p>
<h3>Final Thoughts</h3>
<p>As a final comment on offshoring and outsourcing, I was talking to a technical writer at <a href="http://www.novell.com/home/index.html">Novell</a> last week. Novell apparently has writers and developers in several different countries, including India. This writer works regularly with about 14 writers from Bangalore. She said that within 5 years, technical writing would disappear in the U.S. and be completely enveloped by outsourced companies in India and elsewhere.</p>
<p>I&#8217;m not sure I believe that, because technical writers fit with engineers like peanut butter and jelly &#8212; the two go together really well, and colocation is essential. But the instant you move your engineers to another country, the technical writers are sure to follow. Because Novell has engineers in other countries, they placed their technical writers there too.</p>
<p>By the way, I did interview an Indian technical writer for a podcast last year. You can <a href="http://www.idratherbewriting.com/2006/10/30/technical-writing-in-india-an-interview-with-sandeep-beepu-from-bangalore-india/">listen to it here. </a></p>
<p>Also, there&#8217;s a great listserv to join called <a href="http://groups.yahoo.com/group/technical_writers_india/">Technical Writers of India</a>. They post jobs and have an active discussion regularly. You might also connect with <a href="http://2brahulprabhakar.blogspot.com/">Rahul Prabhakar</a>. He&#8217;s up to date with the latest trends with technical writing in India.</p>
]]></content:encoded>
			<wfw:commentRss>http://idratherbewriting.com/2008/04/09/a-few-questions-from-saudi-arabia-about-technical-writing/feed/</wfw:commentRss>
		<slash:comments>16</slash:comments>
		</item>
		<item>
		<title>Lots of 2008 SXSW Podcasts Now Available</title>
		<link>http://idratherbewriting.com/2008/03/10/lots-of-2008-sxsw-podcasts-now-available/</link>
		<comments>http://idratherbewriting.com/2008/03/10/lots-of-2008-sxsw-podcasts-now-available/#comments</comments>
		<pubDate>Tue, 11 Mar 2008 05:30:00 +0000</pubDate>
		<dc:creator>Tom Johnson</dc:creator>
				<category><![CDATA[blog]]></category>
		<category><![CDATA[37 Signals]]></category>
		<category><![CDATA[Blogging]]></category>
		<category><![CDATA[Creativity]]></category>
		<category><![CDATA[Doc Train]]></category>
		<category><![CDATA[Facebook]]></category>
		<category><![CDATA[Jason Fried]]></category>
		<category><![CDATA[Jeff Jarvis]]></category>
		<category><![CDATA[Mark Zuckerburg]]></category>
		<category><![CDATA[Ning]]></category>
		<category><![CDATA[Podcasting]]></category>
		<category><![CDATA[Scott Abel]]></category>
		<category><![CDATA[STC]]></category>
		<category><![CDATA[STC Summit]]></category>
		<category><![CDATA[WritersUA]]></category>

		<guid isPermaLink="false">http://www.idratherbewriting.com/2008/03/10/lots-of-2008-sxsw-podcasts-now-available/</guid>
		<description><![CDATA[The 2008 South by Southwest Interactive (SXSW) festival, currently underway in Austin, Texas, until March 16, is one of the most popular, high-energy tech conferences of the year. This Interactive conference “celebrates the creativity and passion behind the coolest new media technologies.” Basically, everyone who is doing anything cool on the Internet ends up speaking there. 37 Signals, Facebook, Wired — they’re all there. Many ... <a href="http://idratherbewriting.com/2008/03/10/lots-of-2008-sxsw-podcasts-now-available/">more &#187;</a>]]></description>
			<content:encoded><![CDATA[<p><font color="#0000ff"><a href="http://2008.sxsw.com/coverage/podcasts/"><img src="http://www.idratherbewriting.com/wp-content/uploads/2008/03/sxswfestival.png" alt="Sxswfestival" align="right" border="0" /></a></font>The <a href="http://2008.sxsw.com/coverage/podcasts/">2008 South by Southwest Interactive (SXSW) festival</a>, currently underway in Austin, Texas, until March 16, is one of the most popular, high-energy tech conferences of the year.</p>
<p>This Interactive conference “celebrates the creativity and passion behind the coolest new media technologies.” Basically, everyone who is doing anything cool on the Internet ends up speaking there. <a href="http://www.37signals.com/">37 Signals</a>, <a href="http://facebook.com/">Facebook</a>, <a href="http://www.wired.com/">Wired</a> — they’re all there.</p>
<p>Many of the presentations are interactive panel discussions. Everyone twitters and blogs and texts during the presentations, etc. It’s like a gathering of the Internet geeks and hackers and designers and content creators.</p>
<p><strong>Important: </strong>Because almost every session is recorded and distributed practically the same day, you can start <a href="http://2008.sxsw.com/coverage/podcasts/">attending sessions yourselves</a>. Here’s a list of all the <a href="http://sxsw.com/info/feeds/">feeds available</a>.</p>
<p><span id="more-1405"></span><br />
The interesting thing is, although the sessions are recorded and distributed freely, the attendance at the conference seems as high as ever. I haven’t seen statistics, so I’m making an assumption, but I’m guessing that attendance at the conference actually increases every year because people hear how engaging it is.</p>
<p>Listening to the podcasts makes me wish I could attend. The high energy, the new technologies, the experimental successes, the young entreprenuers — it looks like a big tech gathering with continual parties and meetups between and after sessions.</p>
<p>I wish that the <a href="http://www.stc.org/55thConf/">STC Summit</a>, <a href="http://www.writersua.com/">WritersUA</a>, <a href="http://www.stcatlanta.org/currents.htm">Atlanta Currents</a>, <a href="http://doctrain.com/west">Doc Train</a>, and the dozen other technical writing conferences that take place each year would do the same as SXSW — record the presenters and distribute them in near real-time. If I ever became STC president, I would do this. People are often afraid of the unknown. That’s what Jason Fried of the 37 Signals said in his presentation (<a href="http://audio.sxsw.com/podcast/interactive/panels/2008/SXSW08.INT.20080308.10Things37Signals.mp3">listen to MP3</a>). At 37 Signals, they recently switched to 4 day work-weeks (not 10 hour days), and they help fund their employees’ personal hobbies.</p>
<p><img src="http://2008.sxsw.com/img/ia/mark_zuckerberg.jpg" alt="Mark Zuckerburg, Facebook founder (worth $15 billion)" align="right" border="0" />I’m about 12 minutes into the <a href="http://2008.sxsw.com/coverage/podcasts/">Mark Zuckerburg (Facebook founder) keynote</a> <a href="http://audio.sxsw.com/podcast/interactive/panels/2008/SXSW08.INT.20080309.ZuckerbergKeynote.mp3">(mp3)</a>. This is a must-listen-to interview, not only to hear Zuckerburg talk about the grander mission of Facebook, but to evaluate for yourself whether you think the interviewer tanked the interview.</p>
<p>Before you listen to the interview, <a href="http://www.buzzmachine.com/2008/03/10/zuckerberg-interview-what-went-wrong/">read this post by Jeff Jarvis</a>.</p>
<p>Jarvis writes,</p>
<blockquote><p>She pulled some basic mistakes in interviewing. She interrupted him. The first minute of the conversation, he wanted to talk about people using Facebook to organize against Colombian guerrillas — a fascinating story — and she didn’t let him finish, trying to show that she already knew this. The real mistake was that she wasn’t listening.</p>
<p>… When it became obvious that the audience was hostile to her — cheering Zuckergerg when he told her to ask a question — she acted hurt, as if this hour was about her. Worse, she told us how tough her job was. It wasn’t tough. It was a privilege and she was blowing it. And at the end, when she said that people should send her an email telling her what went wrong, she was so 1994; she didn’t understand that the people in the crowd were already coalescing in Twitter and blogs into an instant consensus. Oh, if only there’d been a back-channel chat projected on the screen beside her. Then, she could have seen.</p></blockquote>
<p dir="ltr">As I’m listening to the interview, in places I can see exactly what Jarvis is saying. The interviewer isn’t so bad near the beginning, in my opinion, but it’s annoying when she interrupts Zuckerburg and redirects the attention to herself.</p>
<p dir="ltr">Personally, I still haven’t caught the Facebook frenzy. <a href="http://thecontentwrangler.com/">Scott Abel</a> has started an <a href="http://thecontentwrangler.ning.com/">extensive community in Ning</a> for the technical community crowd. You might want to check that out after listening to Zuckerburg.</p>
<p dir="ltr"><strong>Update:</strong> I finished listening to the Zuckerburg podcast. At about the 49 minute mark, the interview takes a really interesting turn. Definitely a spiral downward for the interviewer, as the audience rallies in a  <a href="http://www.techcrunch.com/2008/03/10/the-nuclear-disaster-at-sxsw-was-nothing-more-than-a-witch-burning/">&#8220;witch hunt&#8221; &#8212; as Michael Arrington calls it</a> &#8212; against her. It wouldn&#8217;t have been so bad if Sarah Lacy, the interviewer, had just shrugged her shoulders at the 26 second applause for her <a href="http://www.idratherbewriting.com/2008/03/08/deciding-when-to-speak-up-and-when-to-shut-up/">to shut up</a> &#8212; and then turned the questions over to the audience.</p>
<p dir="ltr">But in such a high pressure situation, she got a bit angry and confused and defensive, which made things worse for her. I wasn&#8217;t there, so my perspective is distorted, but I think the audience was immature to revolt. And Zuckerberg&#8217;s commentary wasn&#8217;t that interesting in itself &#8212; he kept saying Facebook&#8217;s mission is to help people &#8220;communicate and connect,&#8221; and also to &#8220;increase empathy&#8221; yada yada yada.</p>
]]></content:encoded>
			<wfw:commentRss>http://idratherbewriting.com/2008/03/10/lots-of-2008-sxsw-podcasts-now-available/feed/</wfw:commentRss>
		<slash:comments>3</slash:comments>
<enclosure url="http://audio.sxsw.com/podcast/interactive/panels/2008/SXSW08.INT.20080309.ZuckerbergKeynote.mp3" length="30082944" type="audio/mpeg" />
<enclosure url="http://audio.sxsw.com/podcast/interactive/panels/2008/SXSW08.INT.20080308.10Things37Signals.mp3" length="30808896" type="audio/mpeg" />
		</item>
	</channel>
</rss>

