Replace Redirects Guide (#1424)

* replace redirects guide

* update routes documentation

Author: Matthew Sweeney

components/references-mdx/configuration/routes/routes.mdx

@@ -180,11 +180,7 @@ For example, you can use this property in combination with [the `headers` proper
   property can also point to non-Now hosted URLs.
 </Note>
 
-Read more about redirecting your `www.` subdomain to your root domain:
-
-<Card title="www. Redirect Guide" href="/guides/redirect-from-www">
-  Create a redirect from the www. subdomain to your root domain.
-</Card>
+Read more about redirecting your `www.` subdomain to your root domain in the [custom domains documentation](/docs/v2/custom-domains/#redirecting-domains).
 
 ## methods
 

lib/data/guides.json

@@ -329,15 +329,6 @@
     "editUrl": "pages/guides/prevent-uploading-sourcepaths-with-nowignore.mdx",
     "lastEdited": "2019-10-11T23:41:55.000Z"
   },
-  {
-    "title": "Redirect from www. To Your Root Domain with ZEIT Now",
-    "description": "Redirect your visitors to your root domain from the www subdomain when deploying with ZEIT Now.",
-    "published": "2019-01-23T03:00:00.860Z",
-    "authors": ["timothy"],
-    "url": "/guides/redirect-from-www",
-    "editUrl": "pages/guides/redirect-from-www.mdx",
-    "lastEdited": "2019-10-22T21:51:28.000Z"
-  },
   {
     "title": "Setup a GoDaddy Domain with ZEIT Now",
     "description": "Use your GoDaddy registered domain for your ZEIT Now deployments.",

pages/docs/v2/custom-domains.mdx

@@ -4,12 +4,13 @@ import Caption from '~/components/text/caption'
 import Note from '~/components/text/note'
 import Card from '~/components/card'
 import { Image } from '~/components/media'
+import { InlineCode } from '~/components/text/code'
 
 export const meta = {
   title: 'Custom Domains',
   description: 'How to add and use a custom domain with your project.',
   editUrl: 'pages/docs/v2/custom-domains.mdx',
-  lastEdited: '2019-10-17T18:48:32.000Z'
+  lastEdited: '2019-10-30T10:31:11.000Z'
 }
 
 By default, all deployments are assigned a `.now.sh` prefixed domain.
@@ -146,6 +147,20 @@ When a custom domain is assigned as a production domain to a project with a [Now
 
 Reverts take effect immediately, assigning the custom domain to the deployment made prior to the point the revert is effective from.
 
+## Redirecting Domains
+
+You can add domain redirects from the **Domains** tab when more than one domain is present for the project. This provides a way to, for example, redirect a `www` subdomain to an apex domain but can be used in a variety of ways.
+
+To add a redirect, select the domain you want to redirect to from the **Redirect to** dropdown:
+
+<Image
+  src={`${process.env.ASSETS}/docs/custom-domains/redirecting-domains.png`}
+  width={1350 / 2}
+  height={370 / 2}
+  shadow
+/>
+<Caption>A <b>domain redirect</b> that redirects requests made to <InlineCode>www.zeit.rocks</InlineCode> to <InlineCode>zeit.rocks</InlineCode>.</Caption>
+
 ## Removing a Domain
 
 To remove a domain that is assigned to your ZEIT account or team, navigate to the **Domains** tab from the Project Overview and click the **Remove** button for the domain you want to remove:

pages/guides/redirect-from-www.js

@@ -0,0 +1,3 @@
+import redirect from '~/lib/redirect'
+
+export default redirect('/docs/v2/custom-domains/#redirecting-domains')