3 ms·
Python's documentation today[1] is clearly more expansive, better formatted and more readily comprehensible than its documentation from 2001[2] (or even 2008[3]
by zahlman 1y ago
Python's documentation today[1] is clearly more expansive, better formatted and more readily comprehensible than its documentation from 2001[2] (or even 2008[3]). There are multiple entire sections of documentation now that didn't exist before. Standards were just lower back then, partly because a larger percentage of "programmers" were accustomed to wrestling with beasts like C, and partly because systems were much smaller.
https://docs.python.org/3/ https://docs.python.org/3/
https://docs.python.org/2.0/ https://docs.python.org/2.0/
https://docs.python.org/2.5/ https://docs.python.org/2.5/
- motorest 1y ago> Python's documentation today[1] is clearly more expansive, better formatted and more readily comprehensible than its documentation from 2001[2] (or even 2008[3]). Documentation is not a specification. Specifications cover all behavior that should be expected, and specify which behavior is implementation-defined or undefined. If something isn't defined them this is a failure in the specification that requires fixing. The point of a specification is to allow independent parties to do clean room implementations that can be used interchangeably.
- zahlman 1y agoThe majority of the comment I was replying to was about documentation, and I was responding to that.
- otabdeveloper4 1y agoGood documentation cannot be "expansive". Good documentation must be a) thorough and b) minimal. Modern Python documentation is absolutely horrible - there's a shitload of irrelevant rambling while absolutely crucial details are omitted.