[Python-Dev] Moving the developer docs? (original) (raw)

Jesse Noller jnoller at gmail.com
Thu Sep 23 16:06:31 CEST 2010

On Thu, Sep 23, 2010 at 10:01 AM, Barry Warsaw <barry at python.org> wrote:

On Sep 23, 2010, at 08:40 AM, Georg Brandl wrote:

That's right.  It is true that it isn't branch-specific information, and that does cause a little bit of irritation for me too, but neither is Misc/developers.txt or Misc/maintainers.rst.

Of course, we might consider a separate HG repository (I'm all in favor of many small repos, instead of a gigantic sandbox one).  The downside is that I really like the developer docs at docs.python.org, and it would complicate the build process a bit. Ideally, I would really like to see the developer docs live outside the CPython source repository.  There's no reason to tie the dev docs to CPython's svn merge policies, write acls, or release schedules.  Given the way docs.python.org is stitched together, and the fact that we (still ;) haven't moved to a dvcs, this may not be feasible. These docs are better off in the wiki than in the source tree. -Barry

-1 on wiki; wikis are where good information goes off to die.

More information about the Python-Dev mailing list