updating examples
adding comments to the code