sqlite3 bug??

mark carter 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 mailing list