3 ms·
PHP docs are an underrated gem. They get several things right: 1. Individual pages for each function. 2. Clear examples for common usecases. 3. Explicit docu
by captn3m0 2y ago
PHP docs are an underrated gem. They get several things right:
1. Individual pages for each function.
2. Clear examples for common usecases.
3. Explicit documentation for input and return types.
4. The quick search is amazing - it prioritizes library reference over other pages.
5. Clean and useful references to related methods.
The user submitted notes were a big positive a decade ago - they highlighted common gotchas, workarounds, and surprising alternatives, but have gotten dated over time (kinda like SO answers). But the voting mechanism attempts to keep them in check.
Compare https://www.php.net/manual/en/function.str-contains.php https://www.php.net/manual/en/function.str-contains.php to the tiny one paragram you get at https://docs.python.org/3/library/stdtypes.html#str.find https://docs.python.org/3/library/stdtypes.html#str.find (which then redirects most users to a far more confusing explanation about the in operator https://docs.python.org/3/reference/expressions.html#membership-test-operations https://docs.python.org/3/reference/expressions.html#members...
- drivingmenuts 2y agoThe PHP docs pretty much ruined me for any other libraries documentation. Java docs had some nice things - ALL the methods and properties were shown for an object, even if it was inherited. I love Python, but their library documetation is a bit of a mixed bag.
- cr125rider 2y agoWhen they first came out, pre stack overflow, having comments at the bottom with people’s example snippets, tips, and tricks was INSANE! It was so helpful. Shout out early PHP users who helped me so much.