anchor.diff:  The various objects and their properties are documented in much more detail here:
   https://github.com/commonsmachinery/catalog/blob/master/doc/datamodel/core.md
   
  -# Work resources
  +## Media [/media/{mediaID}]
  +A media instance, which is a read-only record of a particular media instance of a Work
  +at the time it was recorded in the catalog.
  +
  +Media instances are intended to be the "raw material" of Works, so access to them
  +may be restricted in the catalog to require a reference via a Work (see Work Media below).
  +
  ++ Model
  +    + Headers
  +    
  +            Link: <https://catalog.elog.io/media/6e1ee592539d7d163613d732>;rel="self"
  +
  +    + Body
  +
  +            {
  +                "id": "6e1ee592539d7d163613d732",
  +                "added_by": "https://catalog.elog.io/users/someUserID",
  +                "added_at": "2014-04-14T02:15:15Z",
  +                "replaces": "https://catalog.elog.io/media/prevMediaID",
  +                "annotations": [{
  +                        "id", "63613d7321ee5396e592d7d1",
  +                        "updated_by": "https://catalog.elog.io/users/anotherUserID",
  +                        "updated_at": "2014-04-14T02:15:15Z",
  +                        "score": 100,
  +                        "property": {
  +                            "propertyName": "title",
  +                            "titleLabel": "Title of the work",
  +                        }
  +                    }],
  +                "metadata": {
  +                        "xmp": "<?xml...",
  +                        "oembed": { "url": "http://some/photo.jpg" }
  +                    }
  +            }
  +
  +### Retrieve a Media [GET]
  ++ Response 200 (application/json)
  +    [Media][]
  +
  +
  +## Media collection [/media{?offset,count,filter,sort}]
  +Given the role of Media as mainly internal raw material means that it often makes more sense to use
  +the Work Media collection instead of this one (see below).
  +
  +
  +### List Media instances [GET]
  +TODO: define filters and sorting.
  +
  +Pagination is supported by returning a `Link` header with links according to 
  +http://tools.ietf.org/html/rfc5005
  +
  ++ Parameters
  +    + offset (number, optional) ... Skip this many records in the result. Default: 0
  +    + count (number, optional) ... Return this many records. Default and max values are system-dependent.
  +    + filter (string, optional) ... Filter responses (see above). Default: no filter.
  +    + sort (string, optional) ... Sort response (see above). Default: "natural" sort.
  +
  ++ Response 200 (application/json)
  +    + Headers
  +    
  +            Link: <?offset=0&count=N&...>;rel="first", <?offset=Z&count=N&...>;rel="last", <?offset=X&count=N&...>;rel="previous", <?offset=Y&count=N&...>;rel="next"
  +
  +    + Body
  +    
  +            []
  +
  +### Create new Media instances [POST]
  +Since creating a Media without a Work may not make much sense in some cases, 
  +this endpoint might be disabled in the catalog.
  +
  +Only the following properties in the request will be used:
  +
  +    - annotations (empty list if omitted)
  +    - metadata (empty object if omitted)
  +    - replaces (null if omitted)
  +
  ++ Request (application/json)
  +    [Media][]
  +    
  ++ Response 201 (application/json)
  +    [Media][]
  +    
   
   ## Work [/works/{id}{?include}]
  -
   A work record.
   
   The annotations can either be manipulated via the sublist in the document, 
   or via the separate Annotation collection endpoint.
  +
  +The Media instances linked to this work can be (and may be required to be)
  +accessed via the Work.  See the Work Media endpoints below.  The list of Media instances
  +in the `media` property always use URLs referencing such an endpoint.  
  +
  +When adding another Work's Media to this Work, add the Work Media endpoint for that other
  +work to the `media` list.  It will be rewritten to the Media endpoint for the target Work.
   
   
   + Parameters
  
positive.code:         }
  
  + Response 200 (application/json)
  
      [Work][]
  
  + Response 409 (application/json)
  
negative.code: 
  TODO
  
  # Collection resources
  
  ## Collection [/collections/{collectionID}]
  