updates to methods to improve documentations