@@ -17,8 +17,14 @@ import Servant.Common.Req
1717import Servant.Docs
1818import Servant.Server
1919
20−-- | Endpoint for PUT requests. The type @a@ is the type of the
21−-- response body that's returned.
20+-- | Endpoint for PUT requests, usually used to update a ressource.
21+-- The type @a@ is the type of the response body that's returned.
22+--
23+-- Example:
24+--
25+-- > -- PUT /books/:isbn
26+-- > -- with a Book as request body, returning the updated Book
27+-- > type MyApi = "books" :> Capture "isbn" Text :> ReqBody Book :> Put Book
2228data Put a
2329 deriving Typeable
2430