changes to proposed usage
more use case examples