TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
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:Robert Lauriston <robert -at- lauriston -dot- com> Date:Mon, 3 Nov 2014 15:29:55 -0800
Hello Robert,
Thanks for that thought but there is two problems with this idea:
1) Review via email isn't very collaborative, it is fine when there is one
reviewer but terribly inefficient when you have 15 potential reviewers. I
suppose this method might work via a SharePoint server but we are primarily
a Linux environment so that will never happen. :]
2) Flare's Word output is legendarily poor. Even with careful attention to
css tuning, it is nearly unusable output, when working with complex
documentation.
Ideally, I am looking for a collaborative tool that allows full editing and
accepts PDF, HTML (with images) input... or perhaps even DITA or XML input.
One tool I did look into is *http://www.fontoxml.com/
<http://www.fontoxml.com/> but *their pricing is really high!
*Best regards,*
Shawn
On Mon, Nov 3, 2014 at 12:18 PM, Robert Lauriston <robert -at- lauriston -dot- com>
wrote:
> If you have Flare, you can export to Word, open that in LibreOffice
> Writer (free, runs on Linux and Mac OS), and turn on Show Changes.
> Save and give that to the SMEs for review.
>
> Or import the Word document in Confluence.
>
> On Mon, Nov 3, 2014 at 9:49 AM, Shawn <shawn -at- cohodata -dot- com> wrote:
> > ... 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).
> > ...
> > Confluence - cons: seems to only allow Word input conversion. I really
> > only have HTML or PDF sources to work with.
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Read about how Georgia System Operation Corporation improved teamwork, communication, and efficiency using Doc-To-Help | http://bit.ly/1lRPd2l