diff --git a/quickstart.mdx b/quickstart.mdx
index 8e2cb6b5e..385524e05 100644
--- a/quickstart.mdx
+++ b/quickstart.mdx
@@ -7,41 +7,33 @@ boost: 3
import SkillMcpPrompt from "/snippets/skill-mcp-prompt.mdx";
-After you complete this guide, you'll have a live documentation site ready to customize and update.
+Deploy a live documentation site and make your first change.
## Before you begin
-Mintlify uses a docs-as-code approach to manage your documentation. Every page on your site has a corresponding file stored in your documentation repository.
-
-When you connect your documentation repository to your project, you can work on your documentation locally or in the web editor and sync any changes to your remote repository.
+Mintlify uses a docs-as-code approach: every page has a corresponding file in your documentation repository. Edit content locally or in the web editor and sync changes to your remote repository.
- Using an AI coding tool?
-
- Copy the following prompt to add the Mintlify [skill](/ai/skillmd) and [MCP server](/ai/model-context-protocol) for better results when updating your documentation.
+ Using an AI coding tool? Copy the prompt below to add the Mintlify [skill](/ai/skillmd) and [MCP server](/ai/model-context-protocol).
## Deploy your documentation site
-Go to [mintlify.com/start](https://mintlify.com/start) and complete the onboarding process. During onboarding, you'll connect your GitHub account, create or select a repository for your documentation, and install the GitHub App to enable automatic deployments.
+Go to [mintlify.com/start](https://mintlify.com/start) and complete onboarding. You'll connect GitHub, create or select a repository, and install the GitHub App for automatic deployments.
-After onboarding, your documentation site deploys and is accessible at your `.mintlify.app` URL.
+Your site deploys to your `.mintlify.app` URL.
- If you want to get started quickly without connecting your own repository, you can skip the Git provider connection during onboarding. Mintlify creates a private repository in a private organization and automatically configures the GitHub App for you.
-
- This lets you use the web editor immediately. If you want to use your own repository later, go to [Git Settings](https://dashboard.mintlify.com/settings/deployment/git-settings) in your dashboard to migrate your content using the Git setup wizard. See [Clone to your own repository](/deploy/github#clone-to-your-own-repository) for details.
+ To get started without your own repository, skip the Git provider connection during onboarding. Mintlify creates a private repository and configures the GitHub App for you, so you can use the web editor immediately. To migrate to your own repository later, use the Git setup wizard in [Git Settings](https://dashboard.mintlify.com/settings/deployment/git-settings). See [Clone to your own repository](/deploy/github#clone-to-your-own-repository).
## View your deployed site
-Your documentation site is now deployed at `https://.mintlify.app`.
-
-Find your exact URL on the **Overview** page of your [dashboard](https://dashboard.mintlify.com/).
+Find your site URL on the **Overview** page of your [dashboard](https://dashboard.mintlify.com/).
![]()
- Your site is ready to view immediately. Use this URL for testing and sharing with your team. Before sharing with your users, you may want to add a [custom domain](/customize/custom-domain).
+ Before sharing with users, add a [custom domain](/customize/custom-domain).
## Make your first change
@@ -66,7 +58,7 @@ Find your exact URL on the **Overview** page of your [dashboard](https://dashboa
- The CLI requires [Node.js](https://nodejs.org/en) v20.17.0 or higher. Use an LTS version for stability.
+ Requires [Node.js](https://nodejs.org/en) v20.17.0 or higher.
@@ -80,40 +72,19 @@ Find your exact URL on the **Overview** page of your [dashboard](https://dashboa
- See [Install the CLI](/cli/install) for full details and troubleshooting.
-
-
- If you haven't already cloned your repository locally, follow the instructions in [Clone your repository](/cli/install#clone-your-repository).
-
-
- Open `index.mdx` in your preferred editor and update the description in the frontmatter:
-
- ```mdx
- ---
- title: "Introduction"
- description: "Your custom description here"
- ---
- ```
+ See [Install the CLI](/cli/install) for details. If you haven't cloned your repository, follow [Clone your repository](/cli/install#clone-your-repository).
-
- Run the following command from your documentation directory:
-
- ```bash
- mint dev
- ```
-
- View your preview at `http://localhost:3000`.
+
+ Update the `description` in `index.mdx`, then run `mint dev` and view your preview at `http://localhost:3000`.
- Commit and push your changes to trigger a deployment:
-
```bash
git add .
git commit -m "Update description"
git push
```
- Mintlify automatically deploys your changes. View your deployment status on the [Overview](https://dashboard.mintlify.com/) page of your dashboard.
+ Mintlify automatically deploys your changes.
@@ -139,10 +110,7 @@ Find your exact URL on the **Overview** page of your [dashboard](https://dashboa
- Click **Publish** in the top-right of the web editor toolbar.
-
-
- On the [Overview](https://dashboard.mintlify.com/) page of your dashboard, you can see your site's deployment status. When it finishes deploying, refresh your documentation site to see your changes live.
+ Click **Publish** in the top-right of the toolbar. Track deployment status on the [Overview](https://dashboard.mintlify.com/) page.
@@ -160,4 +128,4 @@ Find your exact URL on the **Overview** page of your [dashboard](https://dashboa
Use your own domain for your documentation site.
-
\ No newline at end of file
+