more documentation on use cases