minor docs editing/examples improvement