Re: Documenting open source software in product?

Subject: Re: Documenting open source software in product?
From: Sandy Harris <pashley -at- storm -dot- ca>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 12 Jul 2002 11:18:39 -0400

mary -dot- nurminen -at- nokia -dot- com wrote:
> I'm working on documenting a product which has a lot of open source software in it.

Be sure someone looks carefully at the licensing issues.

If you distribute software licensed under the GNU project's General Public
then that license obligates you make source code available, or at least
provide pointers to a site where it can be downloaded. If you distribute
a modified version, you have to make source for your modifications
available too.

There are at least half a dozen other licenses used for Open Source
stuff. GNU have other licenses for libraries and documentation.
Berkeley licenses, Perl uses the "Artistic License", ...

> Have you provided links to any possible documentation available in the web
> on that open source software?

Of course you should do that, including links to docs not in the
actual package -- e.g. FAQs or things from the Linux Documentation
Project (

> Or have you produced original material on the software in question?

If you do that, I suggest doing it separately from the documentation
for your actual product, and under an Open Source license. Contributing
docs to an Open Source project is excellent public relations for any
company that wants the Open Source folks as customers. Also, it may
help relations with the developers. You become a Contributor, part of
the Team, not just a (l)user.

Save $600: Create great-looking Help files and software demos with
RoboHelp Deluxe. Get RoboHelp and RoboDemo - our new demo software - for one
low price. OR Save $100 on RoboHelp Office in June with our mail-in rebate.
Go to

Your monthly sponsorship message here reaches more than
5000 technical writers, providing 2,500,000+ monthly impressions.
Contact Eric (ejray -at- raycomm -dot- com) for details and availability.

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.

Documenting open source software in product?: From: mary.nurminen

Previous by Author: Re: tech-writing tools for Linux
Next by Author: Re: About Themes for Fake Names
Previous by Thread: RE: Documenting open source software in product?
Next by Thread: Re: Documenting open source software in product?

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

Sponsored Ads