DSL improvements

Various quality-of-life improvements to the DSL and documentation updates.

This release makes a lot of small improvements to make the library easier and more sensible to consume, off the back of our recent public release we looked at this from an external point of view.