Apply suggestions from code review

Co-authored-by: Steven <steven@ceriously.com>

docs/deployment.md

@@ -1,5 +1,5 @@
 ---
-description: Learn how to deploy your Next.js app to production either managed or self-hosted.
+description: Learn how to deploy your Next.js app to production, either managed or self-hosted.
 ---
 
 # Deployment
@@ -18,9 +18,9 @@ Congratulations, you are ready to deploy your Next.js application to production.
 This output is generated inside the `.next` folder:
 
 - `.next/chunks/pages` – Each JavaScript file inside this folder relates to the route with the same name. For example, `.next/chunks/pages/about.js` would be the JavaScript chunk loaded when viewing the `/about` route in your application
-- `.next/static/media` – Statically import images from `next/image` are hashed and copied here
+- `.next/static/media` – Statically imported images from `next/image` are hashed and copied here
 - `.next/static/css` – Global CSS files for all pages in your application
-- `.next/server/pages` – The HTML and JavaScript entry points prerendered from the server. The `.nft.json` files are used to understand how to [bundle dependencies](/docs/advanced-features/output-file-tracing.md)
+- `.next/server/pages` – The HTML and JavaScript entry points prerendered from the server. The `.nft.json` files are created when [Output File Tracing](/docs/advanced-features/output-file-tracing.md) is enabled and contain all the file paths that depend on a given page.
 - `.next/server/chunks` – Shared JavaScript chunks used in multiple places throughout your application
 - `.next/cache` – Output for the build cache and cached images, responses, and pages from the Next.js server. Using a cache helps decrease build times and improve performance of loading images
 
@@ -30,14 +30,14 @@ All JavaScript code inside `.next` has been **compiled** and browser bundles hav
 
 [Vercel](https://vercel.com/) is a frontend cloud platform from the creators of Next.js. It's the fastest way to deploy your managed Next.js application with zero configuration.
 
-When deploying to Vercel, the `next build` output is automatically transformed and optimized for you, including:
+When deploying to Vercel, the platform automatically detects Next.js, runs `next build`, and optimizes the build output for you, including:
 
 - Persisting cached assets across deployments if unchanged
-- Immutable deployments with a unique URL for every commit
+- [Immutable deployments](https://vercel.com/features/previews) with a unique URL for every commit
 - [Pages](/docs/basic-features/pages.md) are automatically statically optimized, if possible
 - Assets (JavaScript, CSS, images, fonts) are compressed and served from a [Global Edge Network](https://vercel.com/features/infrastructure)
 - [API Routes](/docs/api-routes/introduction.md) are automatically optimized as isolated [Serverless Functions](https://vercel.com/features/infrastructure) that can scale infinitely
-- [Middleware](/docs/middleware.md) are automatically optimized as [Edge Functions](https://vercel.com/edge) that have zero cold starts and boot instantly
+- [Middleware](/docs/middleware.md) are automatically optimized as [Edge Functions](https://vercel.com/features/edge-functions) that have zero cold starts and boot instantly
 
 In addition, Vercel provides features like:
 
@@ -47,7 +47,7 @@ In addition, Vercel provides features like:
 - Support for [Environment Variables](https://vercel.com/docs/environment-variables)
 - Support for [Custom Domains](https://vercel.com/docs/custom-domains)
 - Support for [Image Optimization](/docs/basic-features/image-optimization.md) with `next/image`
-- Instant global deployments by pushing to git
+- Instant global deployments via `git push`
 
 You can start using Vercel (for free) through a personal hobby account, or create a team to start the next big thing. Learn more about [Next.js on Vercel](https://vercel.com/solutions/nextjs) or read the [Vercel Documentation](https://vercel.com/docs).
 
@@ -82,7 +82,7 @@ Then, run `next build` to build your application. Finally, run `next start` to s
 Next.js can be deployed to any hosting provider that supports [Docker](https://www.docker.com/) containers. You can use this approach when deploying to container orchestrators such as [Kubernetes](https://kubernetes.io/) or [HashiCorp Nomad](https://www.nomadproject.io/), or when running inside a single node in any cloud provider.
 
 1. [Install Docker](https://docs.docker.com/get-docker/) on your machine
-1. [Use this example](https://github.com/vercel/next.js/tree/canary/examples/with-docker)
+1. Clone the [with-docker](https://github.com/vercel/next.js/tree/canary/examples/with-docker) example
 1. Build your container: `docker build -t nextjs-docker .`
 1. Run your container: `docker run -p 3000:3000 nextjs-docker`