IMO php "documentation" is different from any other language because the comments can be as important as the official description. This is especially true when the documentation wording is misleading, or there are some traps when using a function in specific contexts, etc. Or functions only available on recent version will have comments with workarounds for older versions.