updated comments with some examples