JavaDocs VS. PHP Manual
Filed in: Web Development — April 16th, 2004
Have developing in JSP for several months, I really wish the Javadocs include sample coding for those methods… It is truth that JavaDocs is a very details documentation, but it lacks EXAMPLES!
For a beginner, code snippet is very helpful to understand the particular functions and put it in practice. “Practice makes perfect”, right? Without examples, it is really hard to understand how to use it.
Perhaps I like the PHP manual too much. In PHP docs, every function will include at least one working example if not SEVERAL. Plus, there are other gurus’ very helpful addition notes at the bottom of function.
I wish someone compiles JavaDocs with examples soon…
