3 ms·
I suspect that the PHP documentation has been the most effective. I know everyone likes hating on PHP, but the docs actually work very well. Part of it is bec
by ChrisMarshallNY 4y ago
I suspect that the PHP documentation has been the most effective.
I know everyone likes hating on PHP, but the docs actually work very well.
Part of it is because the language is basically a big standard library of functions, and those are easy to document, but the integration of user comments into each page has also been extremely useful to me.
Inside Macintosh (Apple's original system docs) was very good. Apple's documentation has steadily degraded, since. The documentation for SwiftUI is basically worthless.
- gregsadetsky 4y agoAgreed! I remember going from mainly writing PHP to Python many years ago and being specifically irked at how Python's core docs, unlike PHP's, didn't "clearly" (in my view) list arguments and, importantly, examples. PHP's one-page-per-func just seemed like a better way of focussing on/laying out everything there was to know about one function. This page [0] looks like it hasn't changed much in the last 15 years and absolutely brings back memories. [0] https://www.php.net/manual/en/function.str-ends-with https://www.php.net/manual/en/function.str-ends-with