Added Javadoc to document our code + cleaned some old comments