This YAML document is not alps, in the same way as it is not XHTML.  So why are we using alps semantics, when we are not using XHTML form semantics?  We are picking and choosing.  In this case, we are choosing a horrible key.  This document is suppose to help engineers build hypermedia APIs.  Telling them to read the ALPs protocol, to understand, does not help, since some of the other stuff in the YAML is alps, and some of it is not alps.