<?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:go='http://ns.gigaom.com/'
xmlns:georss="http://www.georss.org/georss" xmlns:geo="http://www.w3.org/2003/01/geo/wgs84_pos#" xmlns:media="http://search.yahoo.com/mrss/"
	>

<channel>
	<title>GigaOM &#187; Collaboration</title>
	<atom:link href="http://gigaom.com/collaboration/tag/technical-documentation/feed/" rel="self" type="application/rss+xml" />
	<link>http://gigaom.com</link>
	<description></description>
	<lastBuildDate>Fri, 10 Feb 2012 09:35:12 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.com/</generator>
<cloud domain='gigaom.com' port='80' path='/?rsscloud=notify' registerProcedure='' protocol='http-post' />
<image>
		<url>http://0.gravatar.com/blavatar/0db8f6557d022075dbbf010c54d46d93?s=96&#038;d=http%3A%2F%2Fs2.wp.com%2Fi%2Fbuttonw-com.png</url>
		<title>GigaOM &#187; Collaboration</title>
		<link>http://gigaom.com</link>
	</image>
	<atom:link rel="search" type="application/opensearchdescription+xml" href="http://gigaom.com/osd.xml" title="GigaOM" />
	<atom:link rel='hub' href='http://gigaom.com/?pushpress=hub'/>
		<item>
		<title>5 Keys to a Successful Remote Writing Project</title>
		<link>http://gigaom.com/collaboration/5-keys-to-a-successful-remote-writing-project/</link>
		<comments>http://gigaom.com/collaboration/5-keys-to-a-successful-remote-writing-project/#comments</comments>
		<pubDate>Fri, 15 Jan 2010 21:00:13 +0000</pubDate>
		<dc:creator>Will Kelly</dc:creator>
				<category><![CDATA[How-To]]></category>
		<category><![CDATA[project management]]></category>
		<category><![CDATA[remote working]]></category>
		<category><![CDATA[technical documentation]]></category>
		<category><![CDATA[writing]]></category>

		<guid isPermaLink="false">http://webworkerdaily.com/?p=26048</guid>
		<description><![CDATA[I’ve been on my fair share of remote writing projects, including technical writing, contributing to books and writing for publications. Working on such projects and hearing from clients and colleagues about successful (and less so) remote writing projects, I’ve come to see that actions of both [...]<img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=gigaom.com&amp;blog=14960843&amp;post=26048&amp;subd=gigaom2&amp;ref=&amp;feed=1" width="1" height="1" />]]></description>
			<content:encoded><![CDATA[<p><strong><span style="font-size: small;"> </span></strong></p>
<p><strong><span style="font-size: small;"> </span></strong><span style="font-size: small;"><a href="http://webworkerdaily.files.wordpress.com/2010/01/1234386_notebook_and_netbook.jpg"><img  title="1234386_notebook_and_netbook" src="http://webworkerdaily.files.wordpress.com/2010/01/1234386_notebook_and_netbook.jpg?w=150&#038;h=112" alt="" width="150" height="112" class=" alignleft" /></a>I’ve been on my fair share of remote writing projects, including</span><span style="font-size: small;"> technical writing, contributing to books and writing for publications.</span> <span style="font-size: small;">Working on such projects and hearing from clients and colleagues about successful (and less so) remote writing projects, I’ve come to see that </span><span style="font-size: small;">actions of </span><span style="font-size: small;">both the writer and </span><span style="font-size: small;">the client can influence the outcomes.</span></p>
<p><span style="font-size: small;"> </span></p>
<p><span style="font-size: small;">Here are my five keys to successful remote writing projects gleaned from my technical writing career:</span></p>
<p><span style="font-size: small;"> </span></p>
<p><strong><span style="font-size: small;">Good documentation.</span></strong><span style="font-size: small;"> I couldn’t agree more with <a id="m.8c" title="Thursday’s recent post" href="http://gigaom.com/collaboration/3-reasons-telecommuters-need-good-documentation/">Thursday’s recent post</a> about the need for telecommuters to have good documentation. Managing a remote writing project can be a challenging task, so project artifacts like statements of work (SOWs) and status reports can be a helpful audit tool for both the writer and the client. </span><span style="font-size: small;"> You should also consider documentation for remote writing projects to include style guides, templates and source material for the writing assignment(s).<span id="more-26048"></span><br />
</span></p>
<p><span style="font-size: small;"> </span></p>
<p><strong><span style="font-size: small;">Remote access.</span></strong> <span style="font-size: small;">Many of my remote writing projects require</span><span style="font-size: small;"> access to the technology systems I am contracted to document, so remote access is critical to the success of much or my work. Even if you aren’t a technical writer, a remote login can be useful to gain easy  access to project files, internal mailing lists, collaboration tools, and the like. </span><span style="font-size: small;">You should also not just look to just the client to provide remote access and tools for the project.</span><span style="font-size: small;"> Because as you are bringing in outside expertise some clients may also look for you to </span><a id="tnue" title="bring new ideas" href="http://gigaom.com/collaboration/using-google-wave-on-your-first-project-6-tips/">bring new ideas</a><span style="font-size: small;"> like <a id="o:0a" title="Google Wave" href="http://wave.google.com/">Google Wave</a> </span><span style="font-size: small;">to the table</span><span style="font-size: small;">. </span><span style="font-size: small;">As a remote writer, you should also plan for some redundancy for times when your home office Internet connection goes down,</span><span style="font-size: small;"> or you have other communications issues.</span></p>
<p><span style="font-size: small;"> </span></p>
<p><strong><span style="font-size: small;">Technological self-sufficiency.</span></strong> <span style="font-size: small;">In talking with </span><span style="font-size: small;">colleagues and clients, the need for remote writers to be technologically self-sufficient has been a recurring theme</span><span style="font-size: small;">. A writer’s technological self-sufficiency needs to extend to being able to diagnose technical problems and being able to communicate these potential issues in a proactive, clear and concise manner.</span></p>
<p><span style="font-size: small;"> </span></p>
<p><strong><span style="font-size: small;">Mutually </span></strong><strong><span style="font-size: small;">agreed upon publishing formats.</span></strong> <span style="font-size: small;">Agreeing on publishing formats up front may seem like a common-sense move, but with the proliferation of MS Office alternatives, it is important that everybody on the team can open and manipulate the documents with a minimum of issues.</span><span style="font-size: small;"><br />
</span></p>
<p><span style="font-size: small;"> </span></p>
<p><strong><span style="font-size: small;">Managed document</span></strong><strong><span style="font-size: small;"> review cycle. <span style="font-weight: normal;">Getting</span> </span></strong><span style="font-size: small;">editorial and technical reviews of a your work completed can sometimes be a struggle, thanks to conflicting reviewer priorities and no writer on-site, standing at </span><span style="font-size: small;">the reviewer’s door when the review is late. So it is best to implement</span><span style="font-size: small;"> a <a href="http://gigaom.com/collaboration/manage-document-reviews-at-a-distance/">managed review cycle</a> of documents you are writing, including accountability for yourself, accountability on the client/team side, review guidelines, and a schedule.</span></p>
<p><span style="font-size: small;"> </span></p>
<p><span style="font-size: small;"><em>Do you work as a remote writer? </em></span><span style="font-size: small;"><em>Share your tips and advice below for successful remote writing projects.</em></span></p>
<p><span style="font-size: small;">Artwork by <a href="http://www.sxc.hu/">stock.xchng</a> user: </span><a href="http://www.sxc.hu/profile/dmpop">dmpop</a>.</p>
<p><strong>Related research and analysis from GigaOM Pro:</strong><br />Subscriber content. <a href="http://pro.gigaom.com/?utm_source=collaboration&utm_medium=editorial&utm_campaign=auto3&utm_term=26048+5-keys-to-a-successful-remote-writing-project&utm_content=willkelly">Sign up for a free trial</a>.</p><ul><li><a href="http://pro.gigaom.com/2011/03/why-ipad-2-will-lead-consumers-into-the-post-pc-era/?utm_source=collaboration&utm_medium=editorial&utm_campaign=auto3&utm_term=26048+5-keys-to-a-successful-remote-writing-project&utm_content=willkelly">Why iPad 2 Will Lead Consumers Into the Post-PC&nbsp;Era</a></li><li><a href="http://pro.gigaom.com/2011/03/the-near-term-evolution-of-social-commerce/?utm_source=collaboration&utm_medium=editorial&utm_campaign=auto3&utm_term=26048+5-keys-to-a-successful-remote-writing-project&utm_content=willkelly">The Near-Term Evolution of Social&nbsp;Commerce</a></li><li><a href="http://pro.gigaom.com/2011/02/content-farms-the-players-the-benefits-the-risks/?utm_source=collaboration&utm_medium=editorial&utm_campaign=auto3&utm_term=26048+5-keys-to-a-successful-remote-writing-project&utm_content=willkelly">Content Farms: The Players, The Benefits, The&nbsp;Risks</a></li></ul><img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=gigaom.com&amp;blog=14960843&amp;post=26048&amp;subd=gigaom2&amp;ref=&amp;feed=1" width="1" height="1" />]]></content:encoded>
			<wfw:commentRss>http://gigaom.com/collaboration/5-keys-to-a-successful-remote-writing-project/feed/</wfw:commentRss>
		<slash:comments>5</slash:comments>
	
		<media:content url="http://1.gravatar.com/avatar/36f27c41f4e1f6598fcde41633bb984f?s=96&#38;d=retro&#38;r=PG" medium="image">
			<media:title type="html">willkelly</media:title>
		</media:content>

		<media:content url="http:///2010/01/1234386_notebook_and_netbook.jpg?w=150" medium="image">
			<media:title type="html">1234386_notebook_and_netbook</media:title>
		</media:content>
	</item>
		<item>
		<title>Manage Document Reviews at a Distance</title>
		<link>http://gigaom.com/collaboration/manage-document-reviews-at-a-distance/</link>
		<comments>http://gigaom.com/collaboration/manage-document-reviews-at-a-distance/#comments</comments>
		<pubDate>Wed, 04 Nov 2009 19:00:02 +0000</pubDate>
		<dc:creator>Will Kelly</dc:creator>
				<category><![CDATA[How-To]]></category>
		<category><![CDATA[How-to (hack, pack, & backpack)]]></category>
		<category><![CDATA[acrobat]]></category>
		<category><![CDATA[collaborative projects]]></category>
		<category><![CDATA[document review]]></category>
		<category><![CDATA[Microsoft Word]]></category>
		<category><![CDATA[technical documentation]]></category>

		<guid isPermaLink="false">http://webworkerdaily.com/?p=22049</guid>
		<description><![CDATA[Conducting a thorough editorial, technical and content review of business and technical documents is challenging for many organizations, but a geographically dispersed workforce can make it even more difficult. Here are some tips to help better manage document reviews at a distance: Establish review guidelines. Truth [...]<img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=gigaom.com&amp;blog=14960843&amp;post=22049&amp;subd=gigaom2&amp;ref=&amp;feed=1" width="1" height="1" />]]></description>
			<content:encoded><![CDATA[<p><strong> </strong><a href="http://webworkerdaily.files.wordpress.com/2009/10/1162222_38679791.jpg"><img  title="1162222_38679791" src="http://webworkerdaily.files.wordpress.com/2009/10/1162222_38679791.jpg?w=133&#038;h=150" alt="1162222_38679791" width="133" height="150" class=" alignleft" /></a>Conducting a thorough editorial, technical and content review of business and technical documents is challenging for many organizations, but a geographically dispersed workforce can make it even more difficult.</p>
<p>Here are some tips to help better manage document reviews at a distance:</p>
<p><strong>Establish review guidelines.</strong> Truth be told, many organizations don&#8217;t know how to review and approve a document. As such, it is important to set out how you want your reviewers to check over each document. Your review guidelines should:<span id="more-22049"></span></p>
<ul>
<li>Instruct the reviewers to follow procedures step-by-step. Tell them to point out incorrect steps and identify why the step is in error.</li>
<li>Encourage the reviewers to look for better ways to present data, or identify if a different function or listing that would work better in the same situation.</li>
<li>Instruct reviewers to check to see if the artwork (listings, figures, illustrations, tables) corresponds with the references in the text.</li>
<li>Tell the reviewers to test  each line of program code and describe any problems.</li>
</ul>
<p><strong>Designate document stakeholders. </strong>Have a designated document stakeholder check over the document(s) undergoing review to help set review priorities and free up resources to ensure the document review happens on deadline. The stakeholders can also tie the document review into the overall project plan, if needed.<strong> </strong></p>
<p><strong>Identify primary and backup reviewers.</strong> This is a commonsense first step when project teams span multiple time zones, and even continents. If the primary reviewer is unavailable to resolve a question, then the team can always go to the backup reviewer.<br />
<strong><br />
Set a realistic review schedule. </strong>It is rare that a stressed and harried project team can make a full document review in just one pass. So depending on your project schedule, take the initiative to manage expectations and set a review schedule that ensures reviewers are going to add value to the documents they are reviewing.<br />
<strong><br />
Use online collaboration and version control.</strong> WebWorkerDaily regularly covers the latest in <a id="ov5k" title="collaboration" href="http://webworkerdaily.com/tag/collaboration/">collaboration</a> tools. Using one of these tools can help you better manage the review process with your team.<br />
<strong><br />
Use electronic document review tools. </strong>With Microsoft Word and Adobe Acrobat you can mark up and comment on electronic documents just as you can with pen and ink on a hardcopy document &#8212; there&#8217;s no need to fax documents any more. If your team is reviewing an XML-based document, look towards a solution like <a id="lo1m" title="LiveTechDocs" href="http://www.livetechdocs.com/">LiveTechDocs</a> (I <a id="tm1w" title="reviewed it" href="http://gigaom.com/collaboration/manage-technical-document-reviews-with-livetechdocs/">reviewed it</a> for WWD).</p>
<div id="attachment_15410" class="wp-caption aligncenter" style="width: 617px"><a href="http://webworkerdaily.files.wordpress.com/2009/07/livetechdocs.png"><img  title="LiveTechDocs" src="http://webworkerdaily.files.wordpress.com/2009/07/livetechdocs.png?w=607&#038;h=347" alt="LiveTechDocs" width="607" height="347" class=" alignleft" /></a><p class="wp-caption-text">LiveTechDocs Application</p></div>
<p><em>How do you manage document reviews?</em></p>
<p>Image credit: <a href="http://www.sxc.hu/profile/svilen001">svilen001</a> from <a href="http://www.sxc.hu/">sxc.hu</a>.</p>
<p><strong>Related research and analysis from GigaOM Pro:</strong><br />Subscriber content. <a href="http://pro.gigaom.com/?utm_source=collaboration&utm_medium=editorial&utm_campaign=auto3&utm_term=22049+manage-document-reviews-at-a-distance&utm_content=willkelly">Sign up for a free trial</a>.</p><ul><li><a href="http://pro.gigaom.com/2011/03/why-ipad-2-will-lead-consumers-into-the-post-pc-era/?utm_source=collaboration&utm_medium=editorial&utm_campaign=auto3&utm_term=22049+manage-document-reviews-at-a-distance&utm_content=willkelly">Why iPad 2 Will Lead Consumers Into the Post-PC&nbsp;Era</a></li><li><a href="http://pro.gigaom.com/2011/03/the-near-term-evolution-of-social-commerce/?utm_source=collaboration&utm_medium=editorial&utm_campaign=auto3&utm_term=22049+manage-document-reviews-at-a-distance&utm_content=willkelly">The Near-Term Evolution of Social&nbsp;Commerce</a></li><li><a href="http://pro.gigaom.com/2011/02/content-farms-the-players-the-benefits-the-risks/?utm_source=collaboration&utm_medium=editorial&utm_campaign=auto3&utm_term=22049+manage-document-reviews-at-a-distance&utm_content=willkelly">Content Farms: The Players, The Benefits, The&nbsp;Risks</a></li></ul><img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=gigaom.com&amp;blog=14960843&amp;post=22049&amp;subd=gigaom2&amp;ref=&amp;feed=1" width="1" height="1" />]]></content:encoded>
			<wfw:commentRss>http://gigaom.com/collaboration/manage-document-reviews-at-a-distance/feed/</wfw:commentRss>
		<slash:comments>2</slash:comments>
	
		<media:content url="http://1.gravatar.com/avatar/36f27c41f4e1f6598fcde41633bb984f?s=96&#38;d=retro&#38;r=PG" medium="image">
			<media:title type="html">willkelly</media:title>
		</media:content>

		<media:content url="http:///2009/10/1162222_38679791.jpg?w=133" medium="image">
			<media:title type="html">1162222_38679791</media:title>
		</media:content>

		<media:content url="http:///2009/07/livetechdocs.png" medium="image">
			<media:title type="html">LiveTechDocs</media:title>
		</media:content>
	</item>
		<item>
		<title>Manage Technical Document Reviews With LiveTechDocs</title>
		<link>http://gigaom.com/collaboration/manage-technical-document-reviews-with-livetechdocs/</link>
		<comments>http://gigaom.com/collaboration/manage-technical-document-reviews-with-livetechdocs/#comments</comments>
		<pubDate>Tue, 07 Jul 2009 20:00:40 +0000</pubDate>
		<dc:creator>Will Kelly</dc:creator>
				<category><![CDATA[CNN Startups]]></category>
		<category><![CDATA[Locations & Services]]></category>
		<category><![CDATA[NYT Startups]]></category>
		<category><![CDATA[Software Apps]]></category>
		<category><![CDATA[SYN Feature Enterprise]]></category>
		<category><![CDATA[livetechdocs]]></category>
		<category><![CDATA[technical documentation]]></category>

		<guid isPermaLink="false">http://webworkerdaily.com/?p=15412</guid>
		<description><![CDATA[Editor&#8217;s note: With this post, we welcome Will Kelly to the WebWorkerDaily team. Will is a technical writer, analyst and consultant living and working in the Washington, D.C. area. His current areas of interest include mobile computing, Web Office suites, online collaboration tools, unified communications, and [...]<img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=gigaom.com&amp;blog=14960843&amp;post=15412&amp;subd=gigaom2&amp;ref=&amp;feed=1" width="1" height="1" />]]></description>
			<content:encoded><![CDATA[<p><em>Editor&#8217;s note: With this post, we welcome Will Kelly to the WebWorkerDaily team. Will is a technical writer, analyst and consultant living and working in the Washington, D.C. area. His current areas of interest include mobile computing, Web Office suites, online collaboration tools, unified communications, and social media.</em></p>
<p><img  title="ltdlogo" src="http://webworkerdaily.files.wordpress.com/2009/07/ltdlogo.png?w=200&#038;h=40" alt="ltdlogo" width="200" height="40" class=" alignleft" />Reviewing technical documentation presents a number of challenges in many organizations. Stakeholders and subject matter experts are too busy or too dismissive of documentation to give it a thorough review, meaning project managers and writers often need to follow up with face-to-face meetings. As web workers, we sometimes miss out on the opportunity for face-to-face contact, putting us at a greater disadvantage when managing document technical reviews. Therefore, it is imperative for us to put the right tools and processes in place to manage technical documentation collaboration and reviews.</p>
<p><a href="http://livetechdocs.com/">LiveTechDocs</a> can help. It&#8217;s an XML-based online collaboration and document review tool that is designed to handle technical documentation, unlike many of the collaborative editing tools that we&#8217;ve reviewed here on WWD.<span id="more-15412"></span></p>
<p>The product is available in a few different flavors:</p>
<ul>
<li>Free Edition with only one project and a reduced number of users</li>
<li>Writer Edition for freelance writers and small to medium businesses</li>
<li>Open Source Edition is free to open-source software projects</li>
<li>Education Edition for educational institutions</li>
<li>Enterprise Edition for large corporations</li>
</ul>
<p>LiveTechDocs earns high marks from me for a clean and consistent user interface. It is obvious this startup invested time, money and resources in the application&#8217;s user experience.</p>
<div id="attachment_15410" class="wp-caption alignnone" style="width: 310px"><img  title="LiveTechDocs" src="http://webworkerdaily.files.wordpress.com/2009/07/livetechdocs.png?w=300&#038;h=171" alt="LiveTechDocs Application" width="300" height="171" class=" alignleft" /><p class="wp-caption-text">LiveTechDocs</p></div>
<p>LiveTechDocs supports both <a href="http://en.wikipedia.org/wiki/DocBook">DocBook</a> 4.x and DocBook 5.x as its standard formats. It&#8217;s simple to use: Upload your documents to the repository and then publish them. After publishing, it is ready for reviewers via the &#8220;Documentation&#8221; tab.</p>
<p>Using LiveTechDocs, authors and reviewers can review all of your XML-based documentation online. LiveTechDocs helps you manage the review by structuring the process, helping it be completed on deadline.</p>
<p>Review comments are all accessible from the dashboard. Document authors and management can also respond to reviewer comments from the dashboard, opening up a dialog between reviewer and writer.</p>
<p>Many online collaboration tool vendors have yet to embrace the technical documentation review process. LiveTechDocs includes management tools that provide status reports via email or online about reviewer comments and status and even remind reviewers when they are running late. Such an audit trail is critical for geographically dispersed teams seeking to improve their document review cycles. I&#8217;d like to see more collaborative tools adopt such management features.</p>
<p>If you are working on XML-based technical documentation then LiveTechDocs is worth a look for its review, management and collaboration tools.</p>
<p><em>What tools do you use for managing technical document review?</em></p>
<p><strong>Related research and analysis from GigaOM Pro:</strong><br />Subscriber content. <a href="http://pro.gigaom.com/?utm_source=collaboration&utm_medium=editorial&utm_campaign=auto3&utm_term=15412+manage-technical-document-reviews-with-livetechdocs&utm_content=willkelly">Sign up for a free trial</a>.</p><ul><li><a href="http://pro.gigaom.com/2011/03/why-ipad-2-will-lead-consumers-into-the-post-pc-era/?utm_source=collaboration&utm_medium=editorial&utm_campaign=auto3&utm_term=15412+manage-technical-document-reviews-with-livetechdocs&utm_content=willkelly">Why iPad 2 Will Lead Consumers Into the Post-PC&nbsp;Era</a></li><li><a href="http://pro.gigaom.com/2011/03/the-near-term-evolution-of-social-commerce/?utm_source=collaboration&utm_medium=editorial&utm_campaign=auto3&utm_term=15412+manage-technical-document-reviews-with-livetechdocs&utm_content=willkelly">The Near-Term Evolution of Social&nbsp;Commerce</a></li><li><a href="http://pro.gigaom.com/2011/02/content-farms-the-players-the-benefits-the-risks/?utm_source=collaboration&utm_medium=editorial&utm_campaign=auto3&utm_term=15412+manage-technical-document-reviews-with-livetechdocs&utm_content=willkelly">Content Farms: The Players, The Benefits, The&nbsp;Risks</a></li></ul><img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=gigaom.com&amp;blog=14960843&amp;post=15412&amp;subd=gigaom2&amp;ref=&amp;feed=1" width="1" height="1" />]]></content:encoded>
			<wfw:commentRss>http://gigaom.com/collaboration/manage-technical-document-reviews-with-livetechdocs/feed/</wfw:commentRss>
		<slash:comments>4</slash:comments>
	
		<media:content url="http://1.gravatar.com/avatar/36f27c41f4e1f6598fcde41633bb984f?s=96&#38;d=retro&#38;r=PG" medium="image">
			<media:title type="html">willkelly</media:title>
		</media:content>

		<media:content url="http:///2009/07/ltdlogo.png" medium="image">
			<media:title type="html">ltdlogo</media:title>
		</media:content>

		<media:content url="http:///2009/07/livetechdocs.png?w=300" medium="image">
			<media:title type="html">LiveTechDocs</media:title>
		</media:content>
	</item>
	</channel>
</rss>
