documentation enhancements adding examples