removing unnecessary method from the API and some refactoring
adding missed documentation