His questions about discoverability seem to assume that people are suggesting not writing any documentation at all. "The idea that you can write one client to

His questions about discoverability seem to assume that people are suggesting not writing any documentation at all. "The idea that you can write one client to access multiple different APIs" is a straw man. The connection he's making between HAL and WS-* is ridiculous.