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.
The main reason I like the comments on php docs is it's helpful for me to see a basic usage example. A lot of docs (your typical 'man' page for instance) just have a dictionary-like wall of text without a usage sample.
That would be nice. If they won't cull the comments, I'd like to see them make the lower rated comments harder to see, or have some kind of warning near them that says "If you use this, you're going to have a bad time."
Comments
In general I like the new design. I do have one thing that I'm not wild about:
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
I agree.
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.
The main reason I like the comments on php docs is it's helpful for me to see a basic usage example. A lot of docs (your typical 'man' page for instance) just have a dictionary-like wall of text without a usage sample.
That would be nice. If they won't cull the comments, I'd like to see them make the lower rated comments harder to see, or have some kind of warning near them that says "If you use this, you're going to have a bad time."
Wow, indeed. Hopefully that's a bug and not that way by design.