Re: Using Synergy configuration management system with Frame

Subject: Re: Using Synergy configuration management system with Frame
From: Robert Lauriston <robert -at- lauriston -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Tue, 17 Nov 2009 08:42:17 -0800

In version control systems, "checked out" and "read-only" are normally
mutually exclusive states. Checking a file out makes it writable,
checking it in makes it read-only. You can get or update local
read-only copies of the files without checking them out.

FrameMaker will give you an error if you try to create a
cross-reference to a file that's read-only.

The big "gotcha" is that two people check out the same file and make
changes, and if it's not a text file, there's no way to merge the two
edits.

On Tue, Nov 17, 2009 at 4:30 AM, Chris Despopoulos
<despopoulos_chriss -at- yahoo -dot- com> wrote:
> Concerning all your graphics files for all books in a single directory...
>
> You should be able to check out the entire directory as read-only.  For a lot of source control systems (no experience with Synergy) you actually keep a local image of what's on the system branch, and you can update it when the controlled branch has changed.  That's separate from actually checking out for edits.  Since you would not have to edit most of the graphics, and since you would want to explicitly check out the graphics you do edit, there should be no problem here.
>
> The only gotcha with a system like this is that you might check out a file for edit, then make an xref to a file that's read-only.  You won't know it's read-only until you try to save it.  So you have to remind yourself to check out the targets of xrefs.  I suppose some plugin could integrate Maker with whatever source control you're using, and force you to check out the target before you make an xref  to it.  But that's another subject.
>
> Finally, I question the wisdom of storing all your graphics in one directory.  It's probably none of my business, but by doing so you make it difficult to transfer a single book.  For example, what if you're going on a trip but want to work on the book in your off time?  Collecting the book is more difficult if the graphics for all books are lumped together.  Just my 2 cents, there...  I'm sure you have your reasons.
>
> cud
>
>
>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Are you looking for one documentation tool that does it all? Author,
> build, test, and publish your Help files with just one easy-to-use tool.
> Try the latest Doc-To-Help 2009 v3 risk-free for 30-days at:
> http://www.doctohelp.com/
>
> Help & Manual 5: The all-in-one help authoring tool. Easy to use
> but still has all the power you need. Get results fast in an intuitive
> authoring environment that works like a familiar word processor.
> http://www.helpandmanual.com/
>
> ---
> You are currently subscribed to TECHWR-L as robert -at- lauriston -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/robert%40lauriston.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
>
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Are you looking for one documentation tool that does it all? Author,
build, test, and publish your Help files with just one easy-to-use tool.
Try the latest Doc-To-Help 2009 v3 risk-free for 30-days at:
http://www.doctohelp.com/

Help & Manual 5: The all-in-one help authoring tool. Easy to use
but still has all the power you need. Get results fast in an intuitive
authoring environment that works like a familiar word processor.
http://www.helpandmanual.com/

---
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


References:
Re: Using Synergy configuration management system with Frame: From: Chris Despopoulos

Previous by Author: Re: Using Synergy configuration management system with Frame files
Next by Author: Re: Documentation Design Suggestions Needed
Previous by Thread: Re: Using Synergy configuration management system with Frame
Next by Thread: Re: Using Synergy configuration management system with Frame


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

Sponsored Ads


Sponsored Ads