Do you feel bad because of the Python docs?
msirenef at lightbird.net
Wed Feb 27 23:43:46 CET 2013
On 02/27/2013 08:22 AM, Antoine Pitrou wrote:
> Mitya Sirenef <msirenef <at> lightbird.net> writes:
>> I think the issue with python documentation is that it ignores the 95/5
>> rule: 95% of people who land on a module's page are only looking for 5%
>> of its information.
> The 95/5 rule is generally a fallacy which ignores that the 5% which the
> readers are expecting to learn about is not the same 5% from reader
> Which means that in the end you would really want a diversity of HOWTOs
> targeted at different usages of the stdlib. But it is a lot of work to
> write *and* maintain.
> (*) cf. http://www.joelonsoftware.com/items/2006/12/09.html
It would be absurd on my part to claim that they're precisely the same
5%. But then again, they don't have to be. Consider that some topics are
covered in the official tutorial while others are omitted -- the authors
of the tutorial were following the same rough 95/5 concept and the idea
that some readers will find stuff they don't need in the tutorial while
at the same time not finding some of what they DO need -- did not stop
them from writing the tutorial, nor does it mean the tutorial is not
Lark's Tongue Guide to Python: http://lightbird.net/larks/
More information about the Python-list