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
The page that you are dropped into for that is not very friendly. I much prefer the layout for a sub-page once you've clicked a link.
In addition, I hope the next "fix" will be to cull the comments. While there are occasionally some worthwhile edge cases documented in the comments, there is also a great deal of spectacularly bad design advice, which doesn't help PHP's reputation among language elitists as being for script kiddies and beginners.
Fixed header takes away screen real estate.
Grey text is hard to read.
Sends every pageview to Google.
I do not like it.
you mean it has analytics, like every other page on the internet.
* Fixed header takes away screen real estate.
it's modern, you know, where people have screens larger than VGA. This isn't 1998 anymore.
* Search does not work without javascript.
Very hard to be a nice guy with this sort of comment. Javascript is part of the web fabric, if you switch it off much of the web breaks. Switch off CSS and you'll notice the page doesn't look very good either. javascript is to behaviour what css is to appearance. I'm really tired of people who switch off js and then complain. Get with the program! Saying something as utterly stupid as this negates any other potentially valid point you might have had.
* I do not like it.
http://weknowmemes.com/2011/05/and-not-a-single-fuck-was-giv...
Either way, I hope they keep with the improvements and accept JS as very important to their future success.
also, remember 1st time i went to php.net. it was a screenfull design (no scroll) with a curved navigation on the side (probably images cut in a table) and everywhere you moused over that navigation a popup with transparent ballon showed... i didnt even read the site content and dismissed it as a dhtml-for-cms fad and contied to use only apache as my backend framework
To all the snark related to "modern", oh you mean the cluster-f*ck of animated javascript and sensory overload that has become the modern web? please.. you can K.I.S.S it.
Still, big improvement. Snarky comments aside, it seems easier on my eyes. Not a big fan of underlined hyperlinks though.
Don't worry, soon it will become illegal to care about usability and then everything can exist for purely aesthetic purposes.
.navbar .brand {
padding: .5em 0 .5em 0;
}
.navbar .brand img {
margin-left: -0.2em;
}