Add DSL description to documentation.

- contains features still to be implemented
3 jobs for 33-make-specification-langauge-more-concise in 8 minutes and 37 seconds (queued for 5 seconds)