Missing docs on proper usage

[xave]

It would be nice if there were a fleshed out example and navigable types on hackage.

https://www.youtube.com/watch?v=_ZE6qO489b0

This video reverse engineered a lot of things, but it could be easier to onboard.

[xave]

I think a complete example with best practices on getting database configs from environment would go a long way. The test suite does have a complete-ish example usage. Except for the simple "database=test" connection line.

[xave]

There should also be an example of loading multiple scripts in one directory in the test suite as that is actual usage. Right now, mds is just a single script. I'd say that's a gap in coverage because how do you know you've tested for that common case?