fixed javadoc class description issues and added comments for the Position class