Message 147946 - Python tracker

➜

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	mark.dickinson
Recipients	Christian.Iversen, docs@python, mark.dickinson
Date	2011-11-19.14:05:22
SpamBayes Score	1.1220036e-05
Marked as misclassified	No
Message-id	<1321711523.56.0.58943237409.issue13433@psf.upfronthosting.co.za>
In-reply-to

Content
> Maybe a note describing that %g is different from the others in this regard? -1 from me; I don't really see that that would improve the documentation. Maybe that's just me, but I expect reference documentation to be clean, and uncluttered with too many warnings. All the necessary information is already there, and adding extra notes like this just increases the total number of words to be read without adding new information. In a tutorial, that would be different ... :-) Leaving this open---others may have different takes on this.

> Maybe a note describing that %g is different from the others in this regard?

-1 from me;  I don't really see that that would improve the documentation.  Maybe that's just me, but I expect reference documentation to be clean, and uncluttered with too many warnings.  All the necessary information is already there, and adding extra notes like this just increases the total number of words to be read without adding new information.

In a tutorial, that would be different ... :-)

Leaving this open---others may have different takes on this.

History
Date	User	Action	Args
2011-11-19 14:05:23	mark.dickinson	set	recipients: + mark.dickinson, docs@python, Christian.Iversen
2011-11-19 14:05:23	mark.dickinson	set	messageid: <1321711523.56.0.58943237409.issue13433@psf.upfronthosting.co.za>
2011-11-19 14:05:22	mark.dickinson	link	issue13433 messages
2011-11-19 14:05:22	mark.dickinson	create