From: Jim Freeze <jim@...>
Date: 2003-05-28T00:18:42+09:00
Subject: Re: Project Directory Structure

On Tuesday, 27 May 2003 at 15:04:10 +0900, Simon Strandgaard wrote:
> 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
    TODO
> > setup.rb
> >   bin/
> >   doc/  # If multi lang, then use doc.en, doc.ja, etc
> >   examples/
> >   ext/
> >     /ext_name?
> >      extconf.rb
> >   lib/
> >   src/
> >      /<other_lang_name>
> >   test/
> 
> abbreviated names is NOT userfriendly to newbies. 

 I think your statement is a little dogmatic, but
 I see your point. For a converse point, as a newby
 I would be confused to see binary/ instead of bin/,
 simply because I expected to see bin/.

> I prefer long names (at least in the top-level dir):
> 
> src => source
> doc => documents/text
> bin => binary
> ext => config/recipy/setup

  I suppose you could swap the above list and use links:

 source -> src
 documents -> doc 
 binary -> bin 

 (Personally, I like it when the names line up. 8-) )

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

  True.
 

-- 
Jim Freeze
----------
The doctrine of human equality reposes on this: that there is no man
really clever who has not found that he is stupid.
		-- Gilbert K. Chesterson