Fully document the DSL

[tjwp]

This should include all the methods in the DSL, where they can be called, and options accepted.

Perhaps this should be a separate document instead of making the README extremely long.