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



PHP does library documentation so much better than other languages. Compare: https://www.php.net/manual/en/function.ceil to https://docs.python.org/3/library/math.html#math.ceil for eg.

- Clear description, signature, types for parameters, return values.

- Examples, which will often cover edge cases.

- Separate page for each method

- A clear changelog section to document changes across versions.

Python on the other hand, gets a single sentence.


Yes, and the idea of using php.net/<function name> as a lookup (which has been the case for decades) makes it so painless




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

Search: