Complete dcomentation with review

Open to suggestion, changes or improves