[Distutils] docs/ vs doc/

Michael Foord fuzzyman at voidspace.org.uk
Tue Sep 21 12:38:50 CEST 2010


I prefer docs. It seems more natural.

Michael

On 21 September 2010 11:35, anatoly techtonik <techtonik at gmail.com> wrote:

> Hi,
>
> I see that distutils2 promotes storing documentation in docs/
> directory while Python sources use Doc/
> I'd like to see this changed before distutils2 is released beta.
>
> In my projects checkouts there are 80 project that use doc/
> directories. Among these are:
> - subversion
> - hg
> - sphinx
> - trac
> - scons
> - twisted
>
> docs/ directory is used by 61 project, the most famous are:
> - xalan
> - fop
> - moinmoin
> - cmd2
> - googlecl
>
>
> There are some arguments for 'doc/':
> 1. there is no plural for 'documentation'
> 2. bin/ is a common name for storing executables, although there is
> plural for 'binary'
> 3. we still use src/ instead of sources/
>
> Any thoughts/objections?
> --
> anatoly t.
> _______________________________________________
> Distutils-SIG maillist  -  Distutils-SIG at python.org
> http://mail.python.org/mailman/listinfo/distutils-sig
>



-- 
http://www.voidspace.org.uk
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/distutils-sig/attachments/20100921/f4ac03f4/attachment.html>


More information about the Distutils-SIG mailing list