Short: ALPS references elements like that. We do it like ALPS does. ALPS doesn't have YAML version, but it has JSON version of the descriptor document. YAML is superset of JSON. Though, I sort of agree with you, that if we use YAML we should use its full power.