Add docs for ProblemDetailsNotFoundHandler

docs/book/not-found-handler.md

@@ -0,0 +1,23 @@
+# Not Found Handler
+
+This library provides a Not Found handler so that returned 404 responses are in
+the problem details format.
+
+This handler will create a problem details `Response` with a `404` status code and
+a problem details body that will be rendered in either JSON or XML as required by
+the request's `Accept` header.
+
+This handler will only return a response if the request's accept header indicates
+that it will accept either JSON or XML.
+
+
+To use this handler in Expressive add it into your pipeline (usually `pipeline.php`)
+immediate before the default `NotFoundHandler`:
+
+
+```
+$app->pipe(\Zend\ProblemDetails\ProblemDetailsNotFoundHandler::class);
+$app->pipe(NotFoundHandler::class);
+```
+
+

docs/book/quick-start.md

@@ -280,3 +280,22 @@ $app->post('/api/domain/transaction', [
     DomainTransactionMiddleware::class,
 ]);
 ```
+
+### Not Found handling
+
+When writing APIs you may also want 404 responses be in the accepted content-type.
+This package provides `ProblemDetailsNotFoundHandler` which will return a
+problem details `Response` with a `404` status if the request can accept either
+JSON or XML.
+
+To use this handler in Expressive add it into your pipeline immediate before the 
+default `NotFoundHandler`:
+
+```
+$app->pipe(\Zend\ProblemDetails\ProblemDetailsNotFoundHandler::class);
+$app->pipe(NotFoundHandler::class);
+```
+
+
+
+

mkdocs.yml

@@ -8,6 +8,7 @@ pages:
         - "Generating Responses": response.md
         - "Exceptions": exception.md
         - "Error Handling Middleware": middleware.md
+        - "Not Found Handler": not-found-handler.md
 site_name: Problem Details
 site_description: 'Problem Details for PSR-7 Applications'
 repo_url: 'https://github.com/zendframework/zend-problem-details'