anchor.diff:   * +index+ (resolved by name to +GET "/"+ route spec)
    * and +energize+ (with metadata set) defined in +some.namespace+
   
  -[source,clojure]
   ----
   (in-ns 'some.namespace)
   
  
positive.code: = Rook
  
  Rook is a set of middleware and handlers to enable metadata-based routing for Ring web applications.
  
  The intention is to expose a Clojure _namespace_ as a web service _resource_; there's a default mapping of HTTP verbs
  and paths to function names; these can be extended or overridden by meta-data on the functions in the namespace.
  
  The end result is that a proper web service resource can be created in very little code.
  
  == Handler Functions
  
  Rook analyzes the public functions of a namespace to determine which functions are invoked and under which circumstances.
  The circumstances are an HTTP verb (GET, POST, etc.) plus a https://github.com/weavejester/clout[Clout] route. The
  route may include keywords. This is called the +path specification+.
  
  Rook applies a naming convention to functions, so simply naming a function with a particular name implies a certain
  path specification.
  
  == Routing
  
  
negative.code: 
  So, if we wrap our handlers in +io.aviso.rook/namespace-middleware+:
  
  ----
  (-> (io.aviso.rook/rook-handler)
   (io.aviso.rook/namespace-middleware 'some.namespace))
  