[rest-practices] text/html representation?

[Mark McLoughlin]

Hey,

I was trying to think of some simple advice for people designing REST
APIs - things like "if you're documenting the URI scheme, it's not
HATEOAS"

Would it be a worthwhile exercise for API designers to add a text/html
representation of their resources? with forms for action buttons etc.

That way you could be confident your really API is hypertext driven. It
would also be a nice way for API users to browse the API

Just a thought ...

Cheers,
Mark.