4 ms·
I stopped taking this seriously after "the documentation is really good". Not sure whether this is your real opinion or you are just making fun of people who s
by premium-concern 10y ago
I stopped taking this seriously after "the documentation is really good".
Not sure whether this is your real opinion or you are just making fun of people who say that.
- justinhj 10y agoWe can't argue objectively about an opinion but take a look at this typical page of the php.net documentation: http://php.net/manual/en/function.usort.php http://php.net/manual/en/function.usort.php It has everything I need to know about the function clearly laid out. The behaviour of sort when elements are the same. A list at the side of related functions that I may want to look at instead. I also like documentation that includes user contributions as these often add useful caveats and usage examples that don't fit well in the general documentation.
- babyrainbow 10y agoPhp documentation is the worst. Some of the reasons.. 1. They have exactly one set of documentation pages for all the php versions. 2. Another thing is that documentation can be quite wrong for even the fundamental stuff. I have seen a core developer blast out in reddit that "The documentation is wrong!", when the other party pointed them towards a piece of documentation. 3. Incomplete or shallow description. Go check out the documentation page for Exceptions in php and try to find information regarding the behavior of return statements in a 'finally' block. Now go an see the respective page in Python documentation and see how in depth the documentation is. And having code samples is not exclusive to Php's documentation..