From: Jim Freeze <jim@...>
Date: 2003-05-27T05:37:01+09:00
Subject: Re: Project Directory Structure

On Tuesday, 27 May 2003 at  4:01:25 +0900, MikkelFJ wrote:
> 
> "Jim Freeze" <jim@freeze.org> wrote in message
> news:20030526125352.A60394@freeze.org...
> 
> > LICENSE
> > Manifest
> > README
> >   bin/
> >   docs/
> >   doc/        # rdoc generated
> >   examples/
> >   ext/
> >     /ext_name?
> >   lib/
> >   packages?/
> >   src/
> >   test/
> 
> It actually annoys me that rdoc uses the 'doc' directory by default.
> 
> I happen to have doc directories already and they contain source
> documentation. How about 'rdoc' for rdoc directories, or 'browse' for
> processed documentation in general.

Are your doc directories browsable or do they just
contain documentation source?
I think this is the stickiest issue. If we use

    doc  # doc source
    rdoc # rdoc - browsable

Where to you put your browsable source?

    man/  ??

> 'examples' are usually listed as 'samples', although I don't know why.
 
I've seen both. There is also the issue of plurality.
Let's take a quick vote. Make your choice:

  sample
  samples
  example
  examples


-- 
Jim Freeze
----------
Common sense is instinct, and enough of it is genius.
		-- Josh Billings