added cleaner documentation w/ examples