Added debugging section to preview deployments documentation

deploy/preview-deployments.mdx

@@ -7,11 +7,11 @@
   Preview deployments are available on [Pro and Enterprise plans](https://mintlify.com/pricing?ref=preview-deployments).
 </Info>
 
 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.
 
 ## Creating preview deployments
 
 Preview deployments are created automatically through pull requests or manually from your dashboard.
 
 ### Automatic previews
 
@@ -44,10 +44,39 @@
   <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>
 
+## Debugging build errors
+
+If your preview deployment fails with a build error, you can check the logs to identify the issue.
+
+### Viewing build logs
+
+1. Go to your [dashboard](https://dashboard.mintlify.com/).
+2. Select **Previews**.
+3. Select the failed preview deployment.
+4. View the build logs in the deployment details.
+
+The logs will show specific error messages that can help you identify issues such as:
+- Invalid MDX syntax
+- Missing files or broken links
+- Configuration errors in `docs.json`
+- Image or asset loading failures
+
+### Common build errors
+
+**Invalid MDX syntax**: Check for unclosed tags, invalid component usage, or malformed frontmatter in your MDX files.
+
+**Missing files**: Verify that all files referenced in your navigation exist and paths are correct.
+
+**Configuration errors**: Review your `docs.json` for syntax errors or invalid configuration values.
+
+**Asset errors**: Ensure all images and assets referenced in your documentation are present in your repository.
+
+After fixing the issue, push your changes to trigger a new build, or manually redeploy the preview.
+
 ## 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. See [Authentication Setup](/deploy/authentication-setup) for more information.