After a conversation in IRC I think I see what this is saying :) I'd recommend:

* Include a couple realistic examples of why we might want to add more than the `md:AssertionConsumerService`
* Include a reference to where the `md:AssertionConsumerService` entry is actually handled over in the `metadata-sp.xml` template

The `metadata-sp.xml` template may actually be a better place for this whole description, actually. The only part that is relevant in this file is the `/Metadata` endpoint which would give the starting point for additional entries.