improved documentation
reworked factory methods for Adopted to be more like Java version, per GitHub ticket #8
improved documentation
improved documentation
finished javadoc comments for java library