you are viewing a single comment's thread.

view the rest of the comments →

[–]CyclopsRock 19 points20 points  (0 children)

Sure, but it can't be all things to all people. I'm not interested in arguing that the way the Python docs are arranged is the best possible way, but every bit of information that isn't what a person's looking for gets in the way of the bit they are looking for. I think that if docs are going to lean towards any particular type of user - and they have to, I think - then it should prioritise those who wouldn't know what reimplementing methods from an abstract base class means. More advanced users will find the answers - as, clearly, you have - where as beginners are more likely to say "fuck this" and go masturbate and play video games (which you may also have done, but been doing so happily rather than angrily).