3 ms·
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 u
by ch0wn 16y ago
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.
- pavel_lishin 16y agoI 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.
- eru 16y agoYes, 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.
- hello_moto 16y agoLike um.... gasp Java?!
- eru 16y agoFor 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.