The general gist is to have a bunch of links with "method" names describing the operations you can perform on it. Supposedly this gets you the advantage of not hardcoding urls into your clients.
Example from Wikipedia:
<account>
<account_number>12345</account_number>
<balance currency="usd">100.00</balance>
<link rel="deposit" href="/account/12345/deposit" />
| Sword of Truth - Terry Goodkind | |
| Age of Misrule - Mark Chadbourn | |
| Kingdom of the Serpent - Mark Chadbourn | |
| Farseer Trilogy - Robin Hobb | |
| Liveship Traders - Robin Hobb | |
| Tawny Man Trilogy - Robin Hobb | |
| Soldier Son Trilogy - Robin Hobb |
| from ubuntu:12.04 | |
| run apt-get install -y wget | |
| run wget http://downloads.drone.io/latest/drone.deb | |
| run dpkg -i drone.deb | |
| expose 8080 | |
| CMD droned |
| import javax.inject.Named; | |
| import org.junit.Test; | |
| import static org.hamcrest.Matchers.is; | |
| import static org.junit.Assert.assertThat; | |
| import com.google.mockwebserver.MockResponse; | |
| import com.google.mockwebserver.MockWebServer; | |
| import com.google.mockwebserver.RecordedRequest; |