homepage

This issue tracker has been migrated to GitHub , and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author Daniel.Ellis
Recipients Daniel.Ellis, Sarbjit.singh, docs@python, eli.bendersky, ezio.melotti
Date 2012年08月08日.16:33:26
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <CAJGew6mViOGMXQB3n1z31Hnu6u=zyKarj2JCWcspCd5MuMX6uw@mail.gmail.com>
In-reply-to <1344442029.94.0.342668698307.issue15586@psf.upfronthosting.co.za>
Content
Thank you Ezio, I will use that as a reference. What is the general
workflow for updating documentation across python versions? Should I check
to see if the documentation for the module changes across python versions
and create patches for each version? Or is it sufficient to create a patch
for one version?
On Wed, Aug 8, 2012 at 12:07 PM, Ezio Melotti <report@bugs.python.org>wrote:
>
> Ezio Melotti added the comment:
>
> Daniel, I would suggest you to start with a basic example that gives an
> idea about how to use the module and its main functionalities. If
> necessary you could add a section at the bottom with more examples.
> You can also show how a method works with a short snippet (2-3 lines) just
> after the documentation of the method, but this doesn't mean that every
> method should have one.
> If you have lot of examples you might consider doing a separate
> tutorial/howto.
>
> As a reference see the examples in
> http://docs.python.org/py3k/library/html.parser.html and
> http://docs.python.org/py3k/library/unittest.html#basic-example.
>
> ----------
>
> _______________________________________
> Python tracker <report@bugs.python.org>
> <http://bugs.python.org/issue15586>
> _______________________________________
>
History
Date User Action Args
2012年08月08日 16:33:29Daniel.Ellissetrecipients: + Daniel.Ellis, ezio.melotti, eli.bendersky, docs@python, Sarbjit.singh
2012年08月08日 16:33:28Daniel.Ellislinkissue15586 messages
2012年08月08日 16:33:26Daniel.Elliscreate

AltStyle によって変換されたページ (->オリジナル) /