[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