add (WIP): start adding javadoc
add (WIP): start adding javadoc