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. -- http://mail.python.org/mailman/listinfo/python-list
