           auth.request(method: .POST, json: authData)
             .newData { data in auth.localDataOverride(data) })
       
-      Second, you may send a request which does _not_ return the complete state of the resource in the response
-      body, but which still changes the state of the resource. You could handle this by initiating a refresh immedately
+      ### Incremental updates
+    
+      You may send a request which does _not_ return the complete state of the resource in the response body,
+      but which still changes the state of the resource. You could handle this by initiating a refresh immedately
       after success:
       
           resource.request(method: .POST, json: ["name": "Fred"])

    /**
      Initiates a GET request to update the state of this resource, unless it is already up to date.
      
      “Up to date” means the following:
      
      - either
          - the resource has data (i.e. `latestData` is not nil),
          - the last request succeeded (i.e. `latestError` _is_ nil), and
          - the timestamp on `latestData` is more recent than `expirationTime`,
      - or
          - the last request failed (i.e. `latestError` is not nil), and
          - the timestamp on `latestError` is more recent than `retryTime`
    
      If the resource is not up to date, this method calls `load()`.
    */

      parameter much like an `href` attribute in an HTML document. Refer to
      [`ResourcePathsSpec`](https://github.com/bustoutsolutions/siesta/blob/master/Tests/ResourcePathsSpec.swift)
      for details.
    
      - SeeAlso:
        - `optionalRelative(_:)`
        - `child(_:)`
