RE: website tech pubs, etc.

Subject: RE: website tech pubs, etc.
From: "McLauchlan, Kevin" <Kevin -dot- McLauchlan -at- safenet-inc -dot- com>
To: Fox Cole <foxcole -at- gmail -dot- com>, "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 22 Jan 2010 17:08:04 -0500

Fox Cole asked:
> Keith wrote:
> . . . In addition to a PDF that gives the entire manual, you
> might also set
> > up separate PDFs for each chapter. . . . It would be a
> blessing to the user
> > to be able to download only the one part he really needs
> instead of the
> > whole thing. I know that would complicate document
> management, so I don't
> > know if you could get away with it.
> >
> On a bit of a tangent, could you explain a little more about
> how it might
> complicate document management? I know I must be overlooking
> quite a number
> of things.
> I've used the separate-chapter approach for quite a while as
> a solo tech
> writer, using OpenOffice to create chapter documents to be
> pulled together
> by a master document. This way I could easily (and
> inexpensively) create a
> different look for the individual chapters versus the whole
> book, as needed,
> and print each chapter to PDF format.. nothing more to it than that.
> Version numbers in the page style header meant each chapter
> could have its
> own version level that wouldn't appear in the complete book,
> and the change
> log for each chapter became part of the change log for the whole.
> But that's just in my own little microcosm... what more would chapter
> document management involve?

Keith will have his own answer, but I believe the problem is PUBLISHING
them as separate chapters.

When you make them available to the outside world in that form, you
pretty much have to give 'em all individual part numbers and track
versions for each such separate little document-lette.

- Kevin

The information contained in this electronic mail transmission
may be privileged and confidential, and therefore, protected
from disclosure. If you have received this communication in
error, please notify us immediately by replying to this
message and deleting it from your computer without copying
or disclosing it.


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:

Explore CAREER options and paths related to Technical Writing,
learn to create SOFTWARE REQUIREMENTS documents, and
get tips on FUNCTIONAL SPECIFICATION best practices. Free at:

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

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 for more resources and info.

Please move off-topic discussions to the Chat list, at:

Re: website tech pubs, etc.: From: Fox Cole

Previous by Author: RE: website tech pubs, etc.
Next by Author: RE: how bad is the job market?
Previous by Thread: Re: website tech pubs, etc.
Next by Thread: SEO resources

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

Sponsored Ads