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-

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/archive%40web.techwr-l.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


Follow-Ups:

References:
Seapine Surround for User Documentation Source Control: From: SB

Previous by Author: Re: What passes, and what doesn't
Next by Author: Fantastic reference tool
Previous by Thread: Seapine Surround for User Documentation Source Control
Next by Thread: Re: Seapine Surround for User Documentation Source Control


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


Sponsored Ads