made improvments to the documentation and id some fixes to be made