I had significant difficulty building and running the Java server because there are two copies of the documentation, which are both incomplete and have some differences. I didn't get things working until I found both docs and pieced them together. One doc is online (http://incubator.apache.org/shindig/developers/java/build.html) and the other is the BUILD-JAVA doc in the project root.
Can we merge the two? It seems as long as we have two copies of the instructions, that they will always be wrong because someone will update one and not the other. It'd be much preferable to have just one and either the BUILD-JAVA file can contain just the URL web page or the link on the web can point to the SVN web client version.