Re: Documentation collaboration - best practices and tools used?

Subject: Re: Documentation collaboration - best practices and tools used?
From: Shawn <shawn -at- cohodata -dot- com>
To: "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Mon, 3 Nov 2014 09:49:29 -0800

Thank you to everyone for your contribution to this thread.

Unfortunately, it seems that most of you didn't share your own workflows?
How to do get SMEs to edit documentation? What are your workflows for new
documents vs revising documents?

Forgive me for possibly repeating myself....
My big/huge problem now is that once I build content in Flare, I have no
easy way of allowing SMEs to edit the document's content (full text
editing, that is). This is causing me so much grief that there is a
conversation about dropping Flare. I don't want this to happen because I'll
lose a lot of Flare's advanced features.

I really need a solution that will work in an environment where Windows OS
is nearly non-existent.

So far, I have exhausted a number of options, like:
- Adobe Acrobat editing - cons: It doesn't allow easy full text editing
(mostly suitable for short commenting)
- Google Docs - cons: No way to *correct* convert a document to gdocs format
- Confluence - cons: seems to only allow Word input conversion. I really
only have HTML or PDF sources to work with.

Someone asked to see my workflow swinlane... I have attached it... warning,
some of the review process doesn't work so it is still a work in progress.
Love to hear from others, your opinions and what works for you.

*Shawn Connelly*
Technical writer
<shawn -at- cohodata -dot- com>

Read about how Georgia System Operation Corporation improved teamwork, communication, and efficiency using Doc-To-Help |


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 for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at

Looking for the archived Techwr-l email discussions? Search our public email archives @


Previous by Author: Re: Large Documents in Word
Next by Author: Re: Documentation collaboration - best practices and tools used?
Previous by Thread: RE: "Technical Communicators: Stop Thinking of These 13 Things"
Next by Thread: Re: Documentation collaboration - best practices and tools used?

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

Sponsored Ads