added javadoc: first draft
fixing doc errors
update the links to firstSteps
improving the doc