[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Linux is not for consumers!



On Thu, Dec 11, 2003 at 08:21:20PM -0600, Terry Hancock wrote:
> 
> The people who know a program best are the ones who work
> on its internals.  No one else can write documentation like the
> guy who built the thing in the first place.  Failing that, you can
> have someone step in and write it, yes.  But it'll never be as
> accurate as you'd like, nor as up-to-date.

This is something of a fallacy.  In some cases the guy that wrote it is
the _last_ guy you want documenting it.  They may take certain
items/features for granted because they have become second nature to
them.  A good compromise is a collaborative effort where a user (or
someone else) of the software/product creates the documentation using
the original author as a resource.  This way you get an outside point of
view.

-- 
Jamin W. Collins

Facts do not cease to exist because they are ignored. --Aldous Huxley,
"Proper Studies", 1927



Reply to: