update dfn schema doc (#315)

* switch array dimension from boolean -> string to specify scope
* support within-record shape expression references
* formatting consistency (generic YAML-ish syntax)
* misc fixes/cleanup

Author: wpbonelli