Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

> 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.



The majority of the comment I was replying to was about documentation, and I was responding to that.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: