Software Development: Useful Documentation

[article] [edit page] [discussion] [history]

From Humanitarian-FOSS Project Development Site

Java (related) API documentation

You need to be comfortable accessing and understanding reference documentation:

Other API documentation

Reference documentation that you might need that is not (directly) related to Java:

  • XHTML 1.0 Specification. XHTML is a reformulation of HTML 4 as an XML application. In general, new HTML documents that you create should conform to this specification (or a later XHTML specification). For the most part that means conforming to the HTML 4 (or later) specification, but with the additions specified in this document.
  • HTML 4.01 Specification. Whenever writing HTML or JSP, you should plan on it conforming to the HTML specificaiton.

Tutorials and reference documentation

I have found the following tutorials useful; I am sure there are others just as good out there.

  • Unix Tutorial. If you are not familiar with working at the command prompt, and you are using either GNU/Linux or Mac OS X, read all the tutorial chapters except Tutorial 7 (Compling Unix Software Packages). Be sure to do all the exercises. This will not take all that long, and will make the rest of the course much easier.
  • J2EE Tutorial. See especially Chapters 11-14 on servlets and JSPs.
  • Servlet and JSP tutorials. From Marty Hall and Larry Brown, Core Servlets and Java Server Pages, Prentice-Hall, 2003. I have found these tutorials quite helpful; however, they do not cover the JSTL.
  • Spring Framework Reference Documentation. This is the user's guide for all of Spring.
  • Developing a Spring Framework MVC application step-by-step by Thomas Risberg, Rick Evans, Portia Tung. This is a superb tutorial that starts from scratch and introduces the main components of writing Spring Framework applications. The database material (at the end) is a little heavy---something that any software developer needs to learn is how to ignore the portions of a tutorial that don't apply to the task at hand.
Personal tools