updated documentation to have examples