doc: first changes for DSL 1.0

Do not revert this PR after the transition period.  It contains
a README banner which needs to be deleted later, but also a
persistent doc file and an unrelated whitespace nit.
Merge pull request #6072 from rolandwalker/dsl_transition_doc

doc: first changes for DSL 1.0