Improved all fucntions and variables descriptions
Reviewed the code.