For better or worse, the one thing that I can say that is very positive about php, is php.net has basically great documentation and it's usually easy enough to find what you need about particular methods. If php didn't have the documentation that they do, it would not be as successful as it is.
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!
We switched from PHP to Python a few years back and the one thing I consistently miss is the documentation. I feel that PHP has far superior documentation in terms of clearly showing arguments, returns, examples etc.
Documentation was originally the reason why I started working on php all those years ago, and that set the bar for every other language that i've working on since!
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.
It reminds me of Drupal circa 2006, not that that's necessarily a bad thing (it's been a tremendously usable site since forever, so if it ain't broke…), but "modern" is a bit of a stretch.
It isn't often that a doc doesn't solve my api level problem but when it does, user notes always save the day. There is always someone who faced same corner case as mine. One of the many advantages of using the world's most popular server side language.
Note that users of extensions like Ghostery will have the search functionality (e.g. http://us2.php.net/results.php?q=curl&l=en&p=all) "broken." You'll have to allow the Google AJAX Search API permissions for it to work.
I guess this is what passes for "design" for people balls-deep in PHP engineering. The old one was at least quaint/retro, this is just kinda "babby's first blog design".
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.
That is a tough one, JavaScript is sort of modern and will come with any language modernizing. Try it on a modern browser like Chrome and using modern settings, like JS:ON (your post has changed 3 times in the last three minutes, I can't keep up)
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
Just looking at the home page, the text being sooo close to the left-hand margin really bothers me. I use a portrait monitor and browse full screen and it just feels odd having to read the text butted up against my monitor border.
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.
[+] [-] programminggeek|12 years ago|reply
[+] [-] alttag|12 years ago|reply
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!
[+] [-] robertfw|12 years ago|reply
[+] [-] johnnymonster|12 years ago|reply
[+] [-] vital101|12 years ago|reply
http://www.php.net/manual/en/
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.
http://www.php.net/manual/en/language.variables.php
[+] [-] alttag|12 years ago|reply
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.
[+] [-] antsar|12 years ago|reply
[+] [-] dasil003|12 years ago|reply
[+] [-] gketuma|12 years ago|reply
[+] [-] Achshar|12 years ago|reply
[+] [-] ineedtosleep|12 years ago|reply
[+] [-] philliphaydon|12 years ago|reply
[+] [-] kenrikm|12 years ago|reply
[+] [-] usingpond|12 years ago|reply
[+] [-] itry|12 years ago|reply
Fixed header takes away screen real estate.
Grey text is hard to read.
Sends every pageview to Google.
I do not like it.
[+] [-] hnriot|12 years ago|reply
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...
[+] [-] shaneofalltrad|12 years ago|reply
Either way, I hope they keep with the improvements and accept JS as very important to their future success.
[+] [-] gcb1|12 years ago|reply
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
[+] [-] jneal|12 years ago|reply
[+] [-] hardwaresofton|12 years ago|reply
[+] [-] beebs93|12 years ago|reply
[+] [-] pdknsk|12 years ago|reply
[+] [-] spacecadet|12 years ago|reply
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.
[+] [-] computer|12 years ago|reply
[+] [-] dictum|12 years ago|reply
[+] [-] pbreit|12 years ago|reply
[+] [-] frodopwns|12 years ago|reply
[+] [-] DrinkWater|12 years ago|reply
[+] [-] dedsm|12 years ago|reply
[+] [-] JimmaDaRustla|12 years ago|reply
[+] [-] drzaiusapelord|12 years ago|reply
Still, big improvement. Snarky comments aside, it seems easier on my eyes. Not a big fan of underlined hyperlinks though.
[+] [-] asdasf|12 years ago|reply
Don't worry, soon it will become illegal to care about usability and then everything can exist for purely aesthetic purposes.