[Python-Dev] Request for guidance on documentation

[Eric S. Raymond]

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.