Reference Library

Technical Resources

These resources are required reading for anybody contributing source code to the project.

The Java Language Specification

http://java.sun.com/docs/books/jls/ -
Written by the creators of the Java Programming Language, this online book is considered by many to be the bible for programming in Java. A must read.

Javadoc

http://java.sun.com/products/jdk/javadoc/ -
Javadoc is the automatic software documentation generator used by Java since it was first released. All code written for this project must be documented using Javadoc conventions.

The Java Code Conventions

http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html -
This Sun document specifies the de-facto standard way of formatting Java code. All code written for this project must follow these conventions.

Version Control with Subversion

http://svnbook.red-bean.com/ -
Written by Ben Collins-Sussman, Brian W. Fitzpatrick & C. Michael Pilato. This is a Subversion manual that currently provides information about Subversion 1.0 and 1.1.

Source Code Philosophy Resources

The following are a set of articles written about the recent source code movements that help illustrate some of the attributes of a collaborative project such as this. You may not agree with all of the points of these articles, but an understanding of them will help in communicating with everyone on the project.

The Cathedral and the Bazaar

http://catb.org/~esr/writings/cathedral-bazaar/ -
Written by Eric S. Raymond, this is a must read for anyone willing to join or support a volunteer project.

Homesteading the Noosphere

http://catb.org/~esr/writings/homesteading/ - Written by Eric S. Raymond, this is a sequel to "The Cathedral and the Bazaar". It details the property and ownership customs of the open-source culture. This analysis has larg implications for anyone interested in organizing large-scale intellectual collaborations such as this project.

Apache License and Distribution FAQ

http://www.apache.org/foundation/licence-FAQ.html - This page answers most of the common queries that we receive about the Apache license, licensing use of the software, and packaging or redistributing it.

  • No labels