[OpenAFS] Documentation project

ted creedon tcreedon@easystreet.com
Fri, 10 Jun 2005 05:48:12 -0700

Please read my message. I asked where do I send it to?

I don't think the average user is going to learn enough about Latex or the
documentation to be effective.

There are hundreds of separate files in the IBM documentation. Who will
proof the edits? Or check the technical accuracy, expecially on all the
different architectures suported?

The IBM documentation looks like it was emitted from a very sophisticated
internal documentation system. 


-----Original Message-----
From: openafs-info-admin@openafs.org [mailto:openafs-info-admin@openafs.org]
On Behalf Of Jeffrey Hutzelman
Sent: Thursday, June 09, 2005 8:09 PM
To: ted creedon
Cc: openafs-info@openafs.org
Subject: Re: [OpenAFS] Documentation project

On Thursday, June 09, 2005 01:31:06 PM -0700 ted creedon
<tcreedon@easystreet.com> wrote:

> ... but I don't think anyone but me will be dong updates anyway.

That doesn't sound like a reasonable assumption to me, either in theory or
in practice.

This is an open-source project, and it needs to be possible for people to
contribute changes to it, including to its documentation.  Not changes of
the form "Ted, please make it say blah".  Changes in the form of patches,
which can be integrated by gatekeepers, without your involvement.

-- Jeffrey T. Hutzelman (N3NHS) <jhutz+@cmu.edu>
   Sr. Research Systems Programmer
   School of Computer Science - Research Computing Facility
   Carnegie Mellon University - Pittsburgh, PA

OpenAFS-info mailing list