             }
         }
 
-    /**
-      Returns the unique resource with the given URL string.
-
-      If the given string is nil, or is not a valid URL, this method returns a resource that always fails.
+    private static let invalidURL = NSURL(string: "")!     // URL we use when given bad URL for a resource
+
+    /**
+      Returns the unique resource with the given URL string, ignoring `baseURL`.
+
+      - SeeAlso: `resourceWithURL(_:)`
     */
     @warn_unused_result
     @objc(resourceWithURLString:)

            }
        }

    private static let invalidURL = NSURL(string: "")!     // URL we use when given bad URL for a resource

    /// Return the unique resource with the given path appended to `baseURL`.
    /// Leading slash is optional, and has no effect.
    @warn_unused_result
    @objc(resourceWithPath:)
    public final func resource(path: String) -> Resource

        }

    /**
      Returns the unique resource with the given URL, ignoring `baseURL`.

      This method will _always_ return the same instance of `Resource` for the same URL within
      the context of a `Service` as long as anyone retains a reference to that resource.
      Unreferenced resources remain in memory (with their cached data) until a low memory event
      occurs, at which point they are summarily evicted.

      - Note: This method always returns a `Resource`, and does not throw errors. If `url` is nil (likely because it
              came from a malformed URL string), this method returns a resource whose requests always fail.
    */
    @warn_unused_result
    public final func resourceWithURL(url: NSURL?) -> Resource
