homepage

The Dev Guide says that it is "managed using the same process as is used for the main Python documentation":
http://docs.python.org/devguide/docquality.html#helping-with-the-developer-s-guide
However, it looks the Dev Guide might not be on the same schedule of getting updated once a day as it says for the main Python documentation:
http://docs.python.org/devguide/docquality.html#helping-with-documentation
It would help to say something about the mechanism by which the Dev Guide gets updated if that mechanism is different from the main Python documentation.

I think there's an hook the rebuilds the devguide whenever someone pushes something.

This commit from 2 days ago--
http://hg.python.org/devguide/rev/d1958a94d0ff
doesn't seem to be reflected in the published version as of yet:
http://docs.python.org/devguide/docquality.html
So maybe there is just a problem with the hook. If it does get rebuilt right away, that would be worth mentioning, too.

The web update hook is broken at the moment:
http://article.gmane.org/gmane.comp.python.devel/134057 

Patch attached.
I also added a note about building the Dev Guide documentation. Unlike the main Python documentation, `make html` for the Dev Guide doesn't seem to install Sphinx automatically.

Hi Ned, you committed two of my Dev Guide patches in the recent past. I was wondering if you would be willing to commit this one as well. Thanks a lot.

I believe you'll find that the "update" target in the Doc Makefile will install or update all the necessary doc tools including Sphinx.

The Doc makefile does install Sphinx, just like it used to install the previous toolchain, but the devguide is a regular Sphinx project which requires you to have Sphinx installed.

Sorry, of course! The devguide is not the docset.

New changeset 706b1fa362a4 by Ned Deily in branch 'default':
Issue #15311: Expand section on helping with the Developer's Guide
http://hg.python.org/devguide/rev/706b1fa362a4 

Thanks for the patch.

The original issue ("Developer Guide doesn't get updated once a day") isn't fixed, though.

Thanks, Ned! Renaming the issue title to be more specific.

Has this issue been resolved? I saw that the following change is on the web site today:
http://hg.python.org/devguide/rev/851adff2d434
(though I didn't verify it immediately, just 6 hours after).

I think MvL fixed it.

I added an automated build process, yes. However, the current text is incorrect as it states that the build occurs immediately through a hook. 
This is not the case; instead, there is a cronjob that pulls changes. I refuse to report the frequency with which this happens, and advise against documenting the status quo, since that may again get outdated. It should be safe to say that changes should be published within a day.

Attaching proposed wording along the lines Martin suggested.

New changeset 864cd63db2bb by Ned Deily in branch 'default':
Closes #15311 - update devguide publication info.
http://hg.python.org/devguide/rev/864cd63db2bb