[Distutils] docs/ vs doc/

anatoly techtonik techtonik at gmail.com
Tue Sep 21 12:35:25 CEST 2010


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.


More information about the Distutils-SIG mailing list