Adding inline code comments

Do not merge yet since I'll be likely to add more docs. But review and feedback is already welcomed so that I can modify this PReq.