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.
Fwd: Seapine Surround for User Documentation Source Control
Subject:Fwd: Seapine Surround for User Documentation Source Control From:Wade Courtney <wade -dot- courtney -at- gmail -dot- com> To:TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Sun, 9 May 2010 15:24:42 -0700
---------- Forwarded message ----------
From: Wade Courtney <wade -dot- courtney -at- gmail -dot- com>
Date: Sun, 9 May 2010 15:22:58 -0700
Subject: Re: Seapine Surround for User Documentation Source Control
To: SB <sylvia -dot- braunstein -at- gmail -dot- com>
Your best option for your ait database is to put it under a network
share that is backed up nightly. I'm not sure how it would behave in a
source control system. Your versioning wouldn't work like you are
expecting it to.
On 05/09/2010, SB <sylvia -dot- braunstein -at- gmail -dot- com> wrote:
> 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.
>
> Your feedback is much appreciated,
>
> Many thanks,
>
> Sylvia
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> 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 wade -dot- courtney -at- gmail -dot- com -dot-
>
> To unsubscribe send a blank email to
> techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
> or visit
>http://lists.techwr-l.com/mailman/options/techwr-l/wade.courtney%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com
>
> Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
>http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
>http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
--
Sent from my mobile device
--
Sent from my mobile device
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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-
