From: Simon Strandgaard <0bz63fz3m1qt3001@...>
Date: 2003-05-27T15:04:10+09:00
Subject: Re: Project Directory Structure

On Tue, 27 May 2003 09:57:30 +0900, Jim Freeze wrote:

> CHANGELOG
> INSTALL   # optional
> LICENSE
> Manifest
> README    # if multi lang, README.en, README.ja, etc
> setup.rb
>   bin/
>      # ruby executables
>      # other executables
>   doc/  # If multi lang, then use doc.en, doc.ja, etc
>      /man
>      /rdoc
>      /rd
>   examples/
>   ext/
>     /ext_name?
>      extconf.rb
>      ... other source
>   lib/
>      # .rb files that go into RUBY_LIB
>      # may want to use parallel directory structure below
>      # site_ruby/<rev>/
>   src/
>      /<other_lang_name>
>   test/
>      # test suites
> 


abbreviated names is NOT userfriendly to newbies. 
I prefer long names (at least in the top-level dir):

src => source
doc => documents/text
bin => binary
ext => config/recipy/setup


BTW:  'data'  is also a useful top-level dir :-)


--
Simon Strandgaard