Coda File System

Improving Coda documentation

From: M. Satyanarayanan <satya_at_cs.cmu.edu>
Date: Sat, 09 Apr 2005 09:32:26 -0400
As Ivan and many others have pointed out, the Coda documentation
is woefully out of date with respect to the actual system.  It
is clearly time to do a major cleanup.   Jan and I will brainstorm
on how best to do this.  We'd greatly appreciate your help, so we'll
figure out how to carve up the work to make it easy for
different people to contribute.

It would help to get a sense of priorities.  Given limited
resources,  how should we prioritize our effort:

  (a) precise and accurate documentation (e.g. man pages),
      that may not be friendly to a novice user

  (b) explanation of key new concepts in Coda relative to POSIX
       (e.g. conflicts, RVM, reintegration, volumes, ACLs,...) that may
      baffle an otherwise expert user

  (c) tutorial and step-by-step guidance to get new Coda
       users up and running, even if many subtleties are glossed over

Please share your thoughts with the whole group so we get
a proper sense of the priorities of this community.
    
               -- Satya
Received on 2005-04-10 20:30:58