Hacker News new | ask | show | jobs
by captn3m0 1309 days ago
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.