I was recently evaluating a several options on github for a tool I needed. All options satisfied my basic requirements, so the choice came down to community/recency, and documentation.
I went with the project that was better documented.
Joke was on me, there had been several great feature updates, but without new documentation.
So, please, I implore OS committers, as much as it may be a pain, please require documentation updates when accepting patches!
A "good enough" system with excellent documentation is going to win out against a better system without the doc documentation to make library feature discovery and use easy.
It'll be interesting to see how node.js develops in this regard. Currently the core documentation is pretty good there, but as the size of the project grows it'll take effort to maintain a certain standard and coverage.
hint php.net/method will take you direct to the docs to check that argument ordering