Improve documentation

Adds a DESCRIPTION explaining the basic idea and some usage
examples. Interaction with MooX::Options is also demonstrated.

Some issues:

1. I didn't touch the SYNOPSIS; so maybe it seems a bit out of sync with the rest of the examples
2. Maybe the examples are a bit verbose
3. There are still some TODOs