     {
     // MARK: Configuration
     
+    /// The API to which this resource belongs. Provides configuration defaults and instance uniqueness.
     public let service: Service
+    
+    /// The canoncial URL of this resource.
     public let url: NSURL? // TODO: figure out what to do about invalid URLs
     
     internal var observers = [ObserverEntry]()

      Directly updates `latestData` without touching the network. Clears `latestError` and broadcasts
      `ResourceEvent.NewData` to observers.
      
      This method is useful in two situations:
      
      First, you may want to construct a more complicated request than `load()` allows (e.g. using a method other than
      GET), but still use the response body as the new state of the resource:
         
          let auth = service.resource("login")

      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(_:)`
