From c659f37d14b7c0339a7f943661edc9efef06e8a4 Mon Sep 17 00:00:00 2001
From: Robin Millette <robin@millette.info>
Date: Wed, 3 Jun 2020 22:18:30 -0400
Subject: [PATCH] docs: Add errors directive to v2 upgrade guide (#53)

* Errors upgrade docs

Based on https://github.com/caddyserver/caddy/issues/3336 discussion.

* Tab vs spaces; fix copy-paste error.

* With requested changes.
---
 src/docs/markdown/v2-upgrade.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/src/docs/markdown/v2-upgrade.md b/src/docs/markdown/v2-upgrade.md
index 86c44d9..f2729a1 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,28 @@ browse /subfolder/
 file_server /subfolder/* browse
 ```
 
+### errors
+
+Custom error pages can be accomplished with [`handle_errors`](/docs/caddyfile/directives/handle_errors).
+
+
+- **v1:**:
+
+```
+errors {
+	404 404.html
+	500 500.html
+}
+```
+
+- **v2:**: 
+
+```
+handle_errors {
+	rewrite * /{http.error.status_code}.html
+	file_server
+}
+```
 
 ### ext