Docs on manually triggering builds and previews

docs.json

@@ -139,6 +139,7 @@
 
                 ]
               },
+              "guides/deployments",
               "contact-support"
             ]
           },

guides/deployments.mdx

@@ -0,0 +1,26 @@
+---
+title: "Deployments"
+description: "Troubleshoot your deployments"
+icon: "boxes"
+---
+
+Your documentation site automatically deploys when you push changes to your connected repository. This requires the Mintlify GitHub app to be properly installed and connected.
+
+If your latest changes are not appearing on your live site, first check that the GitHub app is installed on the account or organization that owns your docs repository. See [GitHub troubleshooting](/settings/github#troubleshooting) for more information.
+
+If the GitHub app is connected, but changes are still not deploying, you can manually trigger a rebuild from your dashboard.
+
+## Manually triggering a deployment
+
+<Steps>
+  <Step title="Verify your latest commit was successful.">
+    Check that your latest commit appears in your docs repository and did not encounter any errors.
+  </Step>
+  <Step title="Manually trigger a deployment.">
+    Go to your [dashboard](https://dashboard.mintlify.com) and select the deploy button.
+  <Frame>
+    <img src="/images/deployments/manual-update-light.png" alt="The manual update button emphasized with an orange rectangle." className="block dark:hidden" />
+    <img src="/images/deployments/manual-update-dark.png" alt="The manual update button emphasized with an orange rectangle." className="hidden dark:block" />
+  </Frame>
+  </Step>
+</Steps>

settings/preview-deployments.mdx

@@ -5,20 +5,51 @@ icon: "scan-eye"
 ---
 
 <Info>
-  Preview Deployments are available on the [Growth and Enterprise plans](https://mintlify.com/pricing?ref=preview-deployments). Please{" "}
+  Preview deployments are available on [Growth and Enterprise plans](https://mintlify.com/pricing?ref=preview-deployments). Please{" "}
   <a href="mailto:[email protected]">contact sales</a> for more information.
 </Info>
 
-Preview Deployments allow you to preview changes to your docs in a live deployment without merging those changes to your production branch.
+Preview deployments let you see how changes to your docs will look before merging to production. Each preview creates a shareable URL that updates automatically as you push new changes.
 
-If you have created a pull or merge request when using Git, the generated preview URL will be available as a comment from the Mintlify bot in the PR. This URL will always reflect the latest deployment changes.
+## Creating preview deployments
 
-## Sharing Preview Deployments
+Preview deployments are created automatically through pull requests or manually from your dashboard.
 
-After generating a preview URL, you can share that link with anybody for them to view.
+### Automatic previews
 
-### Authenticated Preview Deployments
+When you create a pull request, the Mintlify bot automatically adds a link to view the preview deployment in your pull request. The preview updates each time you push new commits to the branch.
 
-If you'd like to restrict access to your Preview Deployments, you can set up preview deployment authentication. When using this authentication method, only Mintlify authenticated users will be able to access your Preview Deployments.
+<Frame>
+  <img src="/images/previews/preview-deployment-light.png" alt="Link to view deployment in the pull request timeline" className="block dark:hidden" />
+  <img src="/images/previews/preview-deployment-dark.png" alt="Link to view deployment in the pull request timeline" className="hidden dark:block" />
+</Frame>
 
-To set up preview deployment authentication, please [contact sales](mailto:[email protected]).
+### Manual previews
+
+You can manually create a preview for any branch if you are on a Growth or Enterprise plan or have the preview deployment add-on.
+
+1. Go to your [dashboard](https://dashboard.mintlify.com/).
+2. Select **Previews**.
+3. Select **Create preview**.
+4. Enter your branch name.
+5. Select **Create deployment**.
+
+## Redeploying a preview
+
+Redeploy a preview to refresh content or retry after a failed deployment.
+
+1. Select the preview from your [dashboard](https://dashboard.mintlify.com/).
+2. Select **Redeploy**.
+
+<Frame>
+  <img src="/images/previews/redeploy-preview-light.png" alt="The Previews menu with the deploy button emphasized by an orange rectangle." className="block dark:hidden" />
+  <img src="/images/previews/redeploy-preview-dark.png" alt="The Previews menu with the deploy button emphasized by an orange rectangle." className="hidden dark:block" />
+</Frame>
+
+## Sharing preview deployments
+
+Preview deployments can be publicly accessible or restricted to authenticated users.
+
+**Public access**: Preview URLs are publicly viewable by default. Share a preview link with anyone who needs to review your changes.
+
+**Restricted access**: Enable preview deployment authentication to limit preview access to authenticated Mintlify users only. [Contact sales](mailto:[email protected]) to set up authentication for your previews.