[Distutils] docs/ vs doc/

Georg Brandl g.brandl at gmx.net
Tue Sep 21 13:34:51 CEST 2010

Am 21.09.2010 12:35, schrieb anatoly techtonik:
> 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'

FWIW, "docs" is probably short for "the documents".

That said, I have no preference and as long as a solution works with both
doc/ and docs/ it's fine with me.


Thus spake the Lord: Thou shalt indent with four spaces. No more, no less.
Four shall be the number of spaces thou shalt indent, and the number of thy
indenting shall be four. Eight shalt thou not indent, nor either indent thou
two, excepting that thou then proceed to four. Tabs are right out.

More information about the Distutils-SIG mailing list