documenting a few more use cases