title: Is there a REST API documentation that only publishes the root URL?
body: <p>I´m trying to design a REST API for my application and I read a lot about best practices and how REST is supposed to work. One of the most important topics about REST is, that the resources should be linked via references and the client should only know the root URL of the API.</p>
  <p>But I cannot find any API documentation that really does this. Every REST API documentation I ever read on the web shows an exact description of the URLs of the possible endpoints.</p>
  <p>Is there any API documentation out there that only shows the root URL and describes how to navigate through the resources?</p>