"For example, you might start at the root resource http://foo.com/api/ http://foo.com/api/ . It returns, as content, a set of subresources that can be requeste

"For example, you might start at the root resource http://foo.com/api/ http://foo.com/api/ . It returns, as content, a set of subresources that can be requested. The API documentation should describe what data the server sends for /api/ -- what format it's in (HTML, XML, JSON, etc), how to find its subresources (<a>, <form>, id'ed elements), and any relationship" Good luck doing that for "FTP, SSH, whatever"