nemo on Nostr: A lot of my angst about Python's terrible documentation can be boiled down to: "If ...
A lot of my angst about Python's terrible documentation can be boiled down to:
"If your documentation requires your user to read a specification, you have failed terribly"
Python suffers this throughout the ecosystem - this is especially visible in the new-ish Packaging Docs, but is even true much earlier. A lot of python documentation links to the PEP, or in some cases just dumps the ABNF grammar at the end-user.
**PL docs are meant for end-users, not language developers**.
"If your documentation requires your user to read a specification, you have failed terribly"
Python suffers this throughout the ecosystem - this is especially visible in the new-ish Packaging Docs, but is even true much earlier. A lot of python documentation links to the PEP, or in some cases just dumps the ABNF grammar at the end-user.
**PL docs are meant for end-users, not language developers**.