formatted and updated comments
added examples