[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.