docs updates, examples