Comment From: markpollack

updated ref docs, added class level javadoc, and added builder test.

merged in 88776728464dbecac301ec20ed013b038717e8e5