updates to DOCUMENTATION and EXAMPLE strings