Improve Dancer2::Plugin documentation

Specifically, give better examples of using the DSL object.

Also fixes various Dancer1/2 typos from a prior global search and
replace.