|
|
|
|
|
|
by RodgerTheGreat
5131 days ago
|
|
|
In addition to the API documentation, there's the "Java Learning Trail", which is a set of step-by-step tutorials with numerous screenshots and tons of example code: http://docs.oracle.com/javase/tutorial/java/index.html Additionally, if you actually page through the Java API documentation, many packages contain overviews describing rationale and how everything fits together- hardly a "dump of class hierarchies with some comments". For example, http://docs.oracle.com/javase/1.4.2/docs/api/java/awt/doc-fi... Personally I think having both a tutorial and browsable API documentation is preferable to dealing with unstructured prose for everything. |
|
|
If you are already a programmer, you will be able to complete this tutorial in less than 2 hours http://docs.python.org/tutorial/, and can start programming Python. Want to learn Perl? http://www.perltutorial.org/. This tutorial thing isn't something that is unique to java, and personally, I find the Perl and Python versions higher quality compared to Java's tutorial.
> Personally I think having both a tutorial and browsable API documentation is preferable to dealing with unstructured prose for everything.
Unstructured prose for everything? What are we talking about? How is http://docs.python.org/library/random.html (description, methods and usage, example code) unstructured prose? When it comes down to which doc is better, it comes down to personal preference. But Java has the best online documentation is far from the truth.