Re: Documentation collaboration - best practices and tools used?

Subject: Re: Documentation collaboration - best practices and tools used?
From: "Stuart Burnfield" <slb -at- westnet -dot- com -dot- au>
To: "Techwr-l" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 31 Oct 2014 09:53:52 +0800

Hi Shawn.

PDF: Acrobat/Adobe Reader is very capable as a review tool as long as
reviewers are not trying to make large-scale additions. A two-minute
demo or half-page cheat sheet will tell reviewers how to use the
insert, delete, replace, highlight and note tools. Changes or
additions larger than a paragraph or two could be drafted in a
separate Google Doc with a comment showing the URL.

Confluence is worth a second look. We don't use it for external
documents, but the templates and macros to support developing and
publishing tech docs do seem to have matured a lot in the last couple
of years. I don't really like the WYSIWYG editor but it's comparable
to Google Docs, so if an author can handle drafting material in one
they should be able to handle the other.

--- Stuart

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Read about how Georgia System Operation Corporation improved teamwork, communication, and efficiency using Doc-To-Help | http://bit.ly/1lRPd2l

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


Follow-Ups:

Previous by Author: Re: Resources for learning Structured Writing?
Next by Author: RE: Acronyms in Marketing Material
Previous by Thread: Re: Documentation collaboration - best practices and tools used?
Next by Thread: Re: Documentation collaboration - best practices and tools used?


What this post helpful? Share it with friends and colleagues:


Sponsored Ads