On Sep 21, 2010, at 01:35 PM, anatoly techtonik wrote:

>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.

What does "promotes" mean?  That only docs/ can be used?

>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

So, almost evenly split. :)

I'm with Michael, I prefer docs/ and that's what I use for Mailman and all my
libraries.  It just *seems* righter. ;)

I still don't quite know in what way distutils2 promotes docs/ but I do think
both choices need to be easily supported.  Also for unittest2, since my docs/
directories just happen to also contain tests.

-Barry

Attachment: signature.asc
Description: PGP signature

_______________________________________________
Distutils-SIG maillist  -  [email protected]
http://mail.python.org/mailman/listinfo/distutils-sig

Reply via email to