Mailing List Archive

[issue15311] Developer Guide doesn't get updated once a day
New submission from Chris Jerdonek <chris.jerdonek@gmail.com>:

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.

----------
components: Devguide
keywords: easy
messages: 165138
nosy: cjerdonek, ezio.melotti
priority: normal
severity: normal
status: open
title: Developer Guide doesn't get updated once a day
versions: Python 3.3

_______________________________________
Python tracker <report@bugs.python.org>
<http://bugs.python.org/issue15311>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/list-python-bugs%40lists.gossamer-threads.com
[issue15311] Developer Guide doesn't get updated once a day [ In reply to ]
Ezio Melotti <ezio.melotti@gmail.com> added the comment:

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

----------
nosy: +georg.brandl, pitrou

_______________________________________
Python tracker <report@bugs.python.org>
<http://bugs.python.org/issue15311>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/list-python-bugs%40lists.gossamer-threads.com
[issue15311] Developer Guide doesn't get updated once a day [ In reply to ]
Chris Jerdonek <chris.jerdonek@gmail.com> added the comment:

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.

----------

_______________________________________
Python tracker <report@bugs.python.org>
<http://bugs.python.org/issue15311>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/list-python-bugs%40lists.gossamer-threads.com
[issue15311] Developer Guide doesn't get updated once a day [ In reply to ]
Ned Deily <nad@acm.org> added the comment:

The web update hook is broken at the moment:

http://article.gmane.org/gmane.comp.python.devel/134057

----------
nosy: +ned.deily
versions: -Python 3.3

_______________________________________
Python tracker <report@bugs.python.org>
<http://bugs.python.org/issue15311>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/list-python-bugs%40lists.gossamer-threads.com
[issue15311] Developer Guide doesn't get updated once a day [ In reply to ]
Chris Jerdonek <chris.jerdonek@gmail.com> added the comment:

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.

----------
keywords: +patch
Added file: http://bugs.python.org/file26341/issue-15311-1.patch

_______________________________________
Python tracker <report@bugs.python.org>
<http://bugs.python.org/issue15311>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/list-python-bugs%40lists.gossamer-threads.com
[issue15311] Developer Guide doesn't get updated once a day [ In reply to ]
Changes by Chris Jerdonek <chris.jerdonek@gmail.com>:


----------
stage: -> patch review

_______________________________________
Python tracker <report@bugs.python.org>
<http://bugs.python.org/issue15311>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/list-python-bugs%40lists.gossamer-threads.com
[issue15311] Developer Guide doesn't get updated once a day [ In reply to ]
Changes by Éric Araujo <merwok@netwok.org>:


----------
nosy: +eric.araujo

_______________________________________
Python tracker <report@bugs.python.org>
<http://bugs.python.org/issue15311>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/list-python-bugs%40lists.gossamer-threads.com
[issue15311] Developer Guide doesn't get updated once a day [ In reply to ]
Chris Jerdonek <chris.jerdonek@gmail.com> added the comment:

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.

----------

_______________________________________
Python tracker <report@bugs.python.org>
<http://bugs.python.org/issue15311>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/list-python-bugs%40lists.gossamer-threads.com
[issue15311] Developer Guide doesn't get updated once a day [ In reply to ]
Ned Deily <nad@acm.org> added the comment:

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

----------

_______________________________________
Python tracker <report@bugs.python.org>
<http://bugs.python.org/issue15311>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/list-python-bugs%40lists.gossamer-threads.com
[issue15311] Developer Guide doesn't get updated once a day [ In reply to ]
Éric Araujo <merwok@netwok.org> added the comment:

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.

----------

_______________________________________
Python tracker <report@bugs.python.org>
<http://bugs.python.org/issue15311>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/list-python-bugs%40lists.gossamer-threads.com
[issue15311] Developer Guide doesn't get updated once a day [ In reply to ]
Ned Deily <nad@acm.org> added the comment:

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

----------

_______________________________________
Python tracker <report@bugs.python.org>
<http://bugs.python.org/issue15311>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/list-python-bugs%40lists.gossamer-threads.com
[issue15311] Developer Guide doesn't get updated once a day [ In reply to ]
Roundup Robot <devnull@psf.upfronthosting.co.za> added the comment:

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

----------
nosy: +python-dev

_______________________________________
Python tracker <report@bugs.python.org>
<http://bugs.python.org/issue15311>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/list-python-bugs%40lists.gossamer-threads.com
[issue15311] Developer Guide doesn't get updated once a day [ In reply to ]
Ned Deily <nad@acm.org> added the comment:

Thanks for the patch.

----------
resolution: -> fixed
stage: patch review -> committed/rejected
status: open -> closed

_______________________________________
Python tracker <report@bugs.python.org>
<http://bugs.python.org/issue15311>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/list-python-bugs%40lists.gossamer-threads.com
[issue15311] Developer Guide doesn't get updated once a day [ In reply to ]
Antoine Pitrou <pitrou@free.fr> added the comment:

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

----------
priority: normal -> critical
resolution: fixed ->
stage: committed/rejected ->
status: closed -> open

_______________________________________
Python tracker <report@bugs.python.org>
<http://bugs.python.org/issue15311>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/list-python-bugs%40lists.gossamer-threads.com