fix references between different pages
add javadoc