Add more usage examples to the documentation

[fpgmaas]

I recently received the feedback that it can be hard to figure out what our tool does from the documentation. We could improve this by adding some examples to our documentation. "Show, don't tell"