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.
Seapine Surround for User Documentation Source Control
Subject:Seapine Surround for User Documentation Source Control From:SB <sylvia -dot- braunstein -at- gmail -dot- com> To:TECHWR-L Whirlers <techwr-l -at- lists -dot- techwr-l -dot- com>, Techshoret <techshoret -at- yahoogroups -dot- com> Date:Sun, 9 May 2010 22:03:05 +0300
Hi,
I am working for a software company. I would like to organized the
documentation and maintain it in a source control tool. We have both Seapine
Surround and Microsoft SharePoint.
Part of our documentation is maintained in MS Word, the other part is
maintained in Author-it with Word and PDF as outputs. At some point, we will
also have HTMLs.
R&D wants the product documentation in Surround under the same tree as the
code, per version. This allows them to take snapshots. I have no problem
with that but I would like my PDFs and HTMLs together with my final (GA)
release but they do not want outputs in there, claiming that the release is
a different process, which means that I will have to store the PDFs and
HTMLs elsewhere.
They also want the rest of the company documentation (for example special
projects) to be maintained in another system (SharePoint) since it is not
product-related.
I was hoping to centralize all the documentation but I see that this is
getting very complicated.
I would like to know if any of you has used Seapine Surround for source
control. I am just wondering if Surround is the right tool for documentation
maintenance.
I also wonder how software companies are managing their documentation.
Use Doc-To-Help's XML-based editor, Microsoft Word, or HTML and
produce desktop, Web, or print deliverables. Just write (or import)
and Doc-To-Help does the rest. Free trial: http://www.doctohelp.com
- Use this space to communicate with TECHWR-L readers -
- Contact admin -at- techwr-l -dot- com for more information -
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-