updating docs with better examples