Hacker News Reader

I came to say that. Even without comparison it should be very obvious that the PHP documentation is incomplete and badly written. The user comments can't make up for that, especially since there is no quality control for them.

The python documentation is an example of good documentation. And again, it's tied to the language's culture, where documentation has a really high priority.

View on HN

I don't know, I think the user comments add a great deal of valuable information - specifically, they're great examples of what you shouldn't do.

They might be valuable, but I'd rather take a single solid, thought-out method over the reports of a hundred random, failed attempts.

The user comment on php.net consists mainly of bad advices with errors in the examples.

Yes, and even the Python documentation has lots of holes in them.

I'd often like a stronger emphasis on the types of arguments and what gets returned.

Like um.... gasp Java?!

For example, if a furctions get a file, they should make it clear whether it's the name of a file or a File-like object. Or whether both are acceptable.

I don't know enough about Java documentation.

Reply on news.ycombinator.com