updated documentation with better examples