me at privacy.net
Sun Jun 17 20:26:59 CEST 2007
Carsten Haese wrote:
> On Sun, 2007-06-17 at 07:43 -0700, 7stud wrote:
>> Please report the whole docs as a bug.
> I imagine the author appreciates constructive criticism. This is not
> constructive criticism.
> In other words: Pointing out specific shortcomings and ways to correct
> them, such as what the OP is doing, is helpful. Calling the entire docs
> a bug is not helpful.
You'll be pleased to know that I was specific, and I suggested a change
that I thought would be good.
Actually, I think the docs are quite good! I went hunting around some
Scheme implementations lately. What was immediately apparent to me was
that the docs weren't nearly as good as those for python. Typical
problems centre about what modules I was supposed to load, and how I was
supposed to use them. What might be obvious to an old hand might not be
obvious to someone coming in from fresh. This is where big projects like
Python tend to score - the docs have been through many iterations.
More information about the Python-list