[Python-Dev] Request for guidance on documentation

Eric S. Raymond esr@thyrsus.com
Fri, 28 Jul 2000 10:26:23 -0400

Fred L. Drake, Jr. <fdrake@beopen.com>:
>   I'm happy to have them under CVS; I think the big issue is *where*.
> I'm not convinced they belong in the same portion of the tree as the
> standard documentation.
>   Here's a thought: we currently have
>   dist/
>       src/
>           Doc/
>   Instead, we could have:
>   dist/
>       docs/
>           howto/
>           standard/
>       src/
>   The howto/ tree could be the howto collection Andrew maintains, and
> standard/ could be the XML version of the documentation once I've
> converted everything (which just shouldn't been in src/ to begin
> with).

This seems eminently reasonable to me.
		<a href="http://www.tuxedo.org/~esr">Eric S. Raymond</a>

"They that can give up essential liberty to obtain a little temporary 
safety deserve neither liberty nor safety."
	-- Benjamin Franklin, Historical Review of Pennsylvania, 1759.