RE: Recommending 3rd-parth books (was RE: using 3rd-party books)

Subject: RE: Recommending 3rd-parth books (was RE: using 3rd-party books)
From: "Susan W. Gallagher" <SGallagher -at- akonix -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 20 Sep 2001 10:40:11 -0700

Actually, I've done both. Back in my Smalltalk days, we found
an author who'd done a book on Smalltalk concentrating on a
competing product. We contracted with him to edit to our
product. It sounded really simple, but got complicated as we
went along.

I finally ended up managing several rewrites to make the book
look like ours and sound "more professional". We did a complete
reformat and index and passed it off as ours. I don't know
what kind of compensation the author received. Nor did I
stick around long enough to see what the customer reaction
was. About two-thirds of the way thru the project, the doc
team was informed that thier last day would be the day the
docs were delivered (but that's a whole other story).

And when I was documenting a CORBA ORB, we routinely included
a section of recommended reading in each developer's guide.
There was no way we could teach the ins and outs of CORBA
development in a product guide. This wasn't my decision, but
I was okay with it. I'm not entirely sure any of our customers
actually read that section of the docs anyway. ;-)

So, yes. Either way, it's been done. But only you can decide
whether it's appropriate for your product and your audience.
And if it involves any substantial rewrites, ask to review
the contract before it's signed.

-Sue Gallagher
sgallagher -at- akonix -dot- com

> We had a similar discussion around our department recently,
> except that
> instead of including a 3rd-party book, we wanted to recommend
> a particular
> book ... Has
> anyone else done
> this sort of thing?...


A landmark hotel, one of America's most beautiful cities, and
three and a half days of immersion in the state of the art:
IPCC 01, Oct. 24-27 in Santa Fe.

+++ Miramo -- Database/XML publishing automation. See us at +++
+++ Seybold SFO, Sept. 25-27, in the Adobe Partners Pavilion +++
+++ More info: +++

You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit for more resources and info.

Previous by Author: RE: Techniques for Estimating Time
Next by Author: RE: Hardest part of getting started?
Previous by Thread: Re: Recommending 3rd-parth books (was RE: using 3rd-party books)
Next by Thread: Framemaker

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

Sponsored Ads