Comment From: markpollack

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

merged in 48bcbd15556446fda09c99826a7f325bf5de15fb