HATEOAS - Should Aye Aye Support it?

[Gisleburt]

http://en.wikipedia.org/wiki/HATEOAS

I'm not a major fan of Hateoas as with every request for data it additionally tells you how the API works (rather than the Aye Aye way of having you just ask the Api how it works and when you ask for data you just get data).

It might be really good to support this in OPTIONS requests, which would be a good match with #15

[Gisleburt]

This can be made to work using generators (see: 9e6c1e3) so probably doesn't need additional work. Eg:

public function getDataEndpoint() {
    yield 'data';
    yield 'links' => getHateoas();
}

This has the benefit of not doing the computationally expensive Hateoas stuff if all you want is the data.

$gen = $controller->getDataEndpoint();
$data = next($gen);