update PR section

Author: ethanpalm

editor.mdx

@@ -257,63 +257,64 @@ This example shows how to add a Themes page to the Profile group.
 }
 ```
 
-## Pull Requests and reviewing changes
-
-Pull requests (or PRs) let you and other people review changes that you've made on a branch and then merge those changes into your documentation.
+## Publishing changes
 
-See how your changes will appear in visual mode.
+Select the **Publish** button to save your changes and make them available.
 
-### Creating a Pull Request on a Branch 
+How your changes are published depends on which branch you are working on:
 
-1. Make your changes on a branch.
-2. Click the **Publish Pull Request** button in the top-right corner of the editor.
-3. Add a Pull Request Title and Description for your pull request. A good title and description will help reviewers understand the changes you've made.
-4. Click **Publish Pull Request**.
+* **Deployment branch**: Updates your live site immediately.
+* **Other branches**: Creates a pull request so you can review changes before they go live.
 
 <Frame>
   <img 
-    src="/images/editor/pull-request-light.png" 
-    alt="Publish pull request button emphasized in the Mintlify web editor" 
+    src="/images/editor/publish-flow-light.png" 
+    alt="The publish button emphasized in the Mintlify web editor" 
     className="block dark:hidden" 
   />
   <img 
-    src="/images/editor/pull-request-dark.png" 
-    alt="Publish pull request button emphasized in the Mintlify web editor" 
+    src="/images/editor/publish-flow-dark.png" 
+    alt="The publish button emphasized in the Mintlify web editor" 
     className="hidden dark:block" 
   />
 </Frame>
 
-### Reviewing Pull Requests
-
-You can review pull requests in your Git platform (GitHub, GitLab).
-
-After you create a pull request, you can see a preview deployment of the changes.
-
-After a reviewer approves a pull request, you can merge it to deploy the changes to your live documentation site.
-
+## Pull Requests and reviewing changes
 
-## Publishing changes
+Pull requests (PRs) let you propose changes from your branch so that other people can review them before merging into your live documentation. This helps ensure that your changes are correct and gives your team a chance to collaborate on content.
 
-Select the **Publish** button to publish your changes to your live documentation site.
+### Creating a pull request on a branch 
 
-The **Publish** button works differently depending on your branch:
+When you're ready to publish changes from your branch:
 
-* **Deployment branch**: Updates your live site immediately. This is usually the `main` branch.
-* **Other branches**: Creates a pull request for review.
+1. Make sure all your changes are saved on your branch.
+1. Select **Publish Pull Request** in the top-right corner of the editor.
+1. Add a title and description for your pull request. A good title and description help reviewers understand the changes you've made.
+1. Select **Publish Pull Request**.
 
 <Frame>
   <img 
-    src="/images/editor/publish-flow-light.png" 
-    alt="The publish button emphasized in the Mintlify web editor" 
+    src="/images/editor/pull-request-light.png" 
+    alt="Publish pull request button emphasized in the Mintlify web editor" 
     className="block dark:hidden" 
   />
   <img 
-    src="/images/editor/publish-flow-dark.png" 
-    alt="The publish button emphasized in the Mintlify web editor" 
+    src="/images/editor/pull-request-dark.png" 
+    alt="Publish pull request button emphasized in the Mintlify web editor" 
     className="hidden dark:block" 
   />
 </Frame>
 
+The web editor will create a pull request in your Git repository and provide a link to view it.
+
+### Reviewing pull requests
+
+Once your pull request is created:
+
+1. **Review your changes**: You and your team members can review your pull request in your Git provider like GitHub or GitLab.
+1. **Make additional changes**: After reviewing, make any changes in your web editor. Saving your changes will update your pull request.
+1. **Merge when ready**: When your pull request is ready, merge it to deploy changes to your live documentation site.
+
 ## Troubleshooting
 
 Here are solutions to common issues you might encounter with the web editor.