I would add a little sales pitch here that in declarative document you get an external profile generated (which you would have to do separately) and you get a lot of configuration that simplifies implementation in your codebase for generating hypermedia responses. 

Or something along those lines (e.g. more polished). And, btw Mr. I like documentation, I like how you right them. Very reader friendly.