From d7f776f6167beed64a4b1934910debf9fa0f9e8e Mon Sep 17 00:00:00 2001
From: Robin Millette <robin@millette.info>
Date: Wed, 3 Jun 2020 18:49:42 -0400
Subject: [PATCH] Errors upgrade docs

Based on https://github.com/caddyserver/caddy/issues/3336 discussion.
---
 src/docs/markdown/v2-upgrade.md | 43 +++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/src/docs/markdown/v2-upgrade.md b/src/docs/markdown/v2-upgrade.md
index 86c44d9..086ced7 100644
--- a/src/docs/markdown/v2-upgrade.md
+++ b/src/docs/markdown/v2-upgrade.md
@@ -20,6 +20,7 @@ This guide won't delve into the new features available -- which are really cool,
 	- [Primary changes](#primary-changes)
 	- [basicauth](#basicauth)
 	- [browse](#browse)
+        - [errors](#errors)	
 	- [ext](#ext)
 	- [fastcgi](#fastcgi)
 	- [gzip](#gzip)
@@ -146,6 +147,48 @@ browse /subfolder/
 file_server /subfolder/* browse
 ```
 
+### errors
+
+Implied file extensions can be done with [`try_files`](/docs/caddyfile/directives/try_files).
+
+Custom error pages can be accomplished with [`handle_errors`](/docs/caddyfile/directives/handle_errors).
+
+
+- **v1:**:
+
+```
+errors {
+	404 404.html # Not Found
+	500 500.html # Internal Server Error
+}
+```
+
+or
+
+```
+errors {
+	* default_error.html
+}
+```
+
+
+- **v2:**: 
+
+```
+handle_errors {
+	rewrite * /{http.error.status_code}.html
+	file_server
+}
+```
+
+or even
+
+```
+handle_errors {
+	rewrite * /{http.error.status_code}
+	reverse_proxy https://http.cat
+}
+```
 
 ### ext