Comment From: markpollack

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

merged in 8edf1bea47cb46e89ce67d42cdc9e5b002cf8286