Add Deployments Page (#1406)

* framework for deployments page

* remove historical overview

* remove immutability

* remove concepts

* update sidebar

* remove add-ons

* remove changes in now 2

* remove redundant redirect

* remove link to changes page

* remove add-ons from sidebar

* draft making deployments

* rephrase making deployments intro

* minor restructure

* update managing deployments

* add api for managing deployments

* merge cli and api

* raise deployment types

* minor

* change migration links

* Apply suggestions from code review

Co-Authored-By: Timothy <[email protected]>
Co-Authored-By: Allen Hai <[email protected]>

* update links

* update links

* replace lambda with serverless function

Author: Matthew Sweeney

components/layout/docs.js

@@ -152,7 +152,7 @@ class withDoc extends React.Component {
                       the version 2 documentation
                     </GenericLink>
                     . If you have yet to upgrade, see the{' '}
-                    <GenericLink href="/guides/upgrade-to-2-0">
+                    <GenericLink href="/guides/migrate-to-zeit-now/">
                       upgrade guide
                     </GenericLink>
                     .

components/references-mdx/builders/advanced/advanced.mdx

@@ -7,7 +7,7 @@ import Tag from '~/components/text/tag'
 
 export const meta = {
   editUrl: 'pages/docs/builders/builders-mdx/advanced/advanced.mdx',
-  lastEdited: '2019-10-28T13:42:13.000Z'
+  lastEdited: '2019-10-22T21:47:59.000Z'
 }
 
 # Advanced Usage
@@ -611,7 +611,7 @@ run Sinatra::Application
 
 ## Developing Your Own Builder
 
-Extending the feature-set of a ZEIT Now deployment is as simple as creating a Builder that takes a list of files and outputs either static files or dynamic [Serverless Functions](/docs/v2/advanced/concepts/serverless-functions).
+Extending the feature-set of a ZEIT Now deployment is as simple as creating a Builder that takes a list of files and outputs either static files or dynamic [Serverless Functions](/docs/v2/serverless-functions/introduction/).
 
 [A full API reference is available to help with creating Builders.](https://github.com/zeit/now/blob/canary/DEVELOPING_A_BUILDER.md)
 

components/references-mdx/builders/official-builders/official-builders.mdx

@@ -9,12 +9,12 @@ import Tag from '~/components/text/tag'
 export const meta = {
   editUrl:
     'pages/docs/builders/builders-mdx/official-builders/official-builders.mdx',
-  lastEdited: '2019-09-25T23:16:10.000Z'
+  lastEdited: '2019-10-22T21:47:59.000Z'
 }
 
 # Official Builders
 
-Builders are modules that transform your source code into compiled outputs, being either static files and/or [Serverless Functions](/docs/v2/advanced/concepts/serverless-functions), which are served by our [CDN at the edge](https://zeit.co/docs/v2/advanced/concepts/cdn-and-global-distribution/).
+Builders are modules that transform your source code into compiled outputs, being either static files and/or [Serverless Functions](/docs/v2/serverless-functions/introduction/), which are served by our [CDN at the edge](/docs/v2/network/caching/).
 
 <Note warning>
   In most cases, advanced Builders usage with configuration is not necessary.

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

@@ -7,7 +7,7 @@ import Note from '~/components/text/note'
 export const meta = {
   editUrl:
     'pages/docs/configuration/configuration-mdx/configuration/configuration.mdx',
-  lastEdited: '2019-10-17T14:44:04.000Z'
+  lastEdited: '2019-10-22T21:47:59.000Z'
 }
 
 # Project
@@ -85,11 +85,11 @@ Furthermore, it also affects any other actions that the user takes within the di
 
 **Valid values:** environment keys and values.
 
-Environment variables passed to the invoked [Serverless Functions](/docs/v2/advanced/concepts/serverless-functions).
+Environment variables passed to the invoked [Serverless Functions](/docs/v2/serverless-functions/introduction/).
 
 <P>
   This example will pass the <InlineCode>MY_KEY</InlineCode> static env to all{' '}
-  <GenericLink href="/docs/v2/advanced/concepts/serverless-functions">
+  <GenericLink href="/docs/v2/serverless-functions/introduction/">
     Serverless Functions
   </GenericLink>{' '}
   and <InlineCode>SECRET</InlineCode> resolved from the{' '}
@@ -149,7 +149,7 @@ Environment variables passed to the invoked [Serverless Functions](/docs/v2/adva
   The following will include all HTML files as-is (to be served statically),
   and <GenericLink href="/docs/v2/advanced/builders">Build</GenericLink> all
   Python files and JS files into{' '}
-  <GenericLink href="/docs/v2/advanced/concepts/serverless-functions">
+  <GenericLink href="/docs/v2/serverless-functions/introduction/">
     Serverless Functions
   </GenericLink>
   .
@@ -193,7 +193,7 @@ For more information on Builds and Builders, see the documentation:
 
 <P>
   This example configures custom routes that map to static files and{' '}
-  <GenericLink href="/docs/v2/advanced/concepts/serverless-functions">
+  <GenericLink href="/docs/v2/serverless-functions/introduction/">
     Serverless Functions
   </GenericLink>
   .
@@ -226,9 +226,9 @@ For more information on routes, see the documentation:
 
 **Valid values:** a list of valid [region identifiers](/docs/v2/advanced/platform/regions-and-providers).
 
-By setting and modifying this value, you can decide the deployment **regions** of the [Serverless Functions](/docs/v2/advanced/concepts/serverless-functions) that get created as a result of the [build steps](/docs/v2/build-step). By default, the closest region to the geographical location of the deployment is used, or if using a Now for Git integration, SFO is used by default.
+By setting and modifying this value, you can decide the deployment **regions** of the [Serverless Functions](/docs/v2/serverless-functions/introduction/) that get created as a result of the [build steps](/docs/v2/build-step). By default, the closest region to the geographical location of the deployment is used, or if using a Now for Git integration, SFO is used by default.
 
-This value does not impact static files or edge caches, since deployments always have a [CDN layer](/docs/v2/advanced/concepts/cdn-and-global-distribution/) in front.
+This value does not impact static files or edge caches, since deployments always have a [CDN layer](/docs/v2/network/caching/) in front.
 
 The special value `all` can be used to target all available regions.
 
@@ -247,7 +247,7 @@ The special value `all` can be used to target all available regions.
 
 **Type**: `Boolean`.
 
-When set to `true`, both the [source view](/docs/v2/advanced/concepts/special-paths#source-view) and [logs view](/docs/v2/advanced/concepts/special-paths#logs-view) will be publicly accessible (when the user is authenticated with ZEIT).
+When set to `true`, both the [source view](/docs/v2/advanced/platform/deployments/#source-view) and [logs view](/docs/v2/advanced/platform/deployments/#logs-view) will be publicly accessible (when the user is authenticated with ZEIT).
 
 <Code lang="json">{`{
   "public": true

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

@@ -7,7 +7,7 @@ import { Code } from '~/components/text/code'
 
 export const meta = {
   editUrl: 'pages/docs/configuration/configuration-mdx/routes/routes.mdx',
-  lastEdited: '2019-10-17T14:44:04.000Z'
+  lastEdited: '2019-10-22T21:47:59.000Z'
 }
 
 # Routes
@@ -219,7 +219,7 @@ As an example, you can use this property when you have an API endpoint and only
   </GenericLink>{' '}
   Builder as an example of a <InlineCode>now.json</InlineCode> configuration
   that tells Now to build JavaScript files with Node.js and outputs them as{' '}
-  <GenericLink href="/docs/v2/advanced/concepts/serverless-functions/">
+  <GenericLink href="/docs/v2/serverless-functions/introduction/">
     Serverless Functions
   </GenericLink>
   .

components/references-mdx/now-cli/commands/remove.mdx

@@ -6,7 +6,7 @@ import { GenericLink } from '~/components/text/link'
 
 export const meta = {
   editUrl: 'pages/docs/now-cli/now-cli-mdx/commands/remove.mdx',
-  lastEdited: '2019-10-15T22:03:42.000Z'
+  lastEdited: '2019-10-22T21:47:59.000Z'
 }
 
 ## Remove
@@ -34,7 +34,7 @@ The `now remove` command, which can be shortened to `now rm`, is used to remove
 
 <Note type="warning">
   By using the{' '}
-  <GenericLink href="/docs/v2/advanced/concepts/urls#project-name">
+  <GenericLink href="/docs/v2/advanced/platform/projects/">
     project name
   </GenericLink>
   , the entire project will be removed from the account unless the <InlineCode>

lib/data/guides.json

@@ -143,7 +143,7 @@
     "url": "/guides/deploying-next-and-mysql-with-now",
     "image": "undefined/guides/deploying-next-mysql-with-now/deploying-next-mysql-with-now.png",
     "editUrl": "pages/guides/deploying-next-and-mysql-with-now.mdx",
-    "lastEdited": "2019-10-14T12:32:29.000Z"
+    "lastEdited": "2019-10-22T21:51:28.000Z"
   },
   {
     "title": "Create and Deploy a Next.js and Prismic App with ZEIT Now",
@@ -309,7 +309,7 @@
     "authors": ["msweeneydev"],
     "url": "/guides/handling-node-request-body",
     "editUrl": "pages/guides/handling-node-request-body.mdx",
-    "lastEdited": "2019-09-24T17:47:39.000Z"
+    "lastEdited": "2019-10-22T21:51:28.000Z"
   },
   {
     "title": "Migrate to ZEIT Now",
@@ -318,7 +318,7 @@
     "authors": ["msweeneydev", "timothy", "skllcrn"],
     "url": "/guides/migrate-to-zeit-now",
     "editUrl": "pages/guides/migrate-to-zeit-now.mdx",
-    "lastEdited": "2019-09-24T17:47:39.000Z"
+    "lastEdited": "2019-10-22T21:51:28.000Z"
   },
   {
     "title": "Prevent Uploading Source Paths with `.nowignore` on ZEIT Now",
@@ -336,7 +336,7 @@
     "authors": ["timothy"],
     "url": "/guides/redirect-from-www",
     "editUrl": "pages/guides/redirect-from-www.mdx",
-    "lastEdited": "2019-10-14T12:32:29.000Z"
+    "lastEdited": "2019-10-22T21:51:28.000Z"
   },
   {
     "title": "Setup a GoDaddy Domain with ZEIT Now",

lib/data/v2/docs.js

@@ -97,47 +97,17 @@ export default [
         name: 'Deploy Hooks',
         href: '/docs/v2/advanced/deploy-hooks'
       },
-      {
-        name: 'Deployment Concepts',
-        overview: '/docs/v2/advanced/concepts/overview',
-        posts: [
-          {
-            name: 'Overview',
-            href: '/docs/v2/advanced/concepts/overview'
-          },
-          {
-            name: 'Lifecycle',
-            href: '/docs/v2/advanced/concepts/lifecycle'
-          },
-          {
-            name: 'Immutability',
-            href: '/docs/v2/advanced/concepts/immutability'
-          },
-          {
-            name: 'URLs',
-            href: '/docs/v2/advanced/concepts/urls'
-          },
-          {
-            name: 'Special Paths',
-            href: '/docs/v2/advanced/concepts/special-paths'
-          },
-          {
-            name: 'Serverless Functions',
-            href: '/docs/v2/advanced/concepts/serverless-functions'
-          },
-          {
-            name: 'CDN and Global Distribution',
-            href: '/docs/v2/advanced/concepts/cdn-and-global-distribution'
-          }
-        ]
-      },
       {
         name: 'Platform',
         posts: [
           {
             name: 'Overview',
             href: '/docs/v2/advanced/platform/overview'
           },
+          {
+            name: 'Deployments',
+            href: '/docs/v2/advanced/platform/deployments'
+          },
           {
             name: 'Projects',
             href: '/docs/v2/advanced/platform/projects'
@@ -146,21 +116,13 @@ export default [
             name: 'Users and Teams',
             href: '/docs/v2/advanced/platform/users-and-teams'
           },
-          {
-            name: 'Add-Ons',
-            href: '/docs/v2/advanced/platform/add-ons'
-          },
-          {
-            name: 'Glossary',
-            href: '/docs/v2/advanced/platform/glossary'
-          },
           {
             name: 'Limits',
             href: '/docs/v2/advanced/platform/limits'
           },
           {
-            name: 'Changes in ZEIT Now 2.0',
-            href: '/docs/v2/advanced/platform/changes-in-now-2-0'
+            name: 'Glossary',
+            href: '/docs/v2/advanced/platform/glossary'
           },
           {
             name: 'Frequently Asked Questions',

pages/docs/api/v1/index.js

@@ -200,7 +200,7 @@ class APIPage extends Component {
                         the version 2 API reference
                       </GenericLink>
                       . If you have yet to upgrade, see the{' '}
-                      <GenericLink href="/guides/upgrade-to-2-0">
+                      <GenericLink href="/guides/migrate-to-zeit-now/">
                         upgrade guide
                       </GenericLink>
                       .

pages/docs/error/application/BODY_NOT_A_STRING_FROM_FUNCTION.mdx

@@ -6,7 +6,7 @@ export const meta = {
   title: 'Body Not A String From Serverless Function',
   description: 'The Serverless Function did not respond with a string.',
   editUrl: 'pages/docs/error/application/BODY_NOT_A_STRING_FROM_FUNCTION.mdx',
-  lastEdited: '2019-09-26T14:00:22.000Z'
+  lastEdited: '2019-10-22T21:47:59.000Z'
 }
 
 #### Application Error
@@ -27,7 +27,7 @@ This is an error with the application.
 
 #### Troubleshoot
 
-- Check the application logs, which can be found at the host URL under [the `/_logs` path](/docs/v2/advanced/concepts/special-paths#logs-view), for example:
+- Check the application logs, which can be found at the host URL under [the `/_logs` path](/docs/v2/advanced/platform/deployments/#logs-view), for example:
   ```
   https://my-deployment-lwbxweoqjo.now.sh/_logs
   ```