Begin improving DSL section

Based on the notes I took while discussing the build and the server code in Dundee.

Note: this will likely be a longer editing effort. Happy to take PRs to
improve this. If it starts to conflict, we can close and then re-open
later.

/cc @JesseCorrington, @manics, @bpindelski, @mtbc, @jburel, @hflynn