Still there are some things that could be improved on that page:
1. I assume the git stuff at the bottom is an alternative to using SVN. If so, the comment "(or alternatively use Subclipse)" could be changed to "or alternatively use Subclipse (instructions here) or Gi (instructions here)" with hyperlinks under each "instructions here" phrase.
2. The instructions about Java1.5 need to be clarified and a screendump should be provided.
3. "Testing (jogl)" should be something more clear, like "Running example code". I'm not sure why there's a reference to JOGL, since this is way above GL, and even way above GLUT. That's like putting (Virtual Machine Code) after a reference to programming with Java. Maybe some text at the top of the tutorial that says JReality is an object-oriented wrapper around JOGL or something to that effect would accomplish what you want.
4. Under "Adding VR data to the project" it says
We have to add the two jars vrData.jar and vrExamples.jar to the classpath. Go to the download page and save the two jars under jreality/lib/.
In Eclipse, right-click on the jreality/lib folder and say Refresh... Then expand the folder, select the two jars and add them to the build path: Right-click on the selection: Build Path->Add to Build Path.
Now run ViewerVR again, you should see the following:
but none of that was necessary for me. Apparently those jars have been placed correctly in the project so that step is unnecessary, as is the grayscale-looking image above that text. I suggest removing it as well.
5. Under Tips and Tricks, list where the tutorials and examples are within the project and suggest running and experimenting with them.