copyedit getting started

Author: ethanpalm

docs.json

@@ -30,7 +30,7 @@
                 "pages": [
                   "editor/getting-started",
                   "editor/content-management",
-                  "editor/branching-workflow",
+                  "editor/branches",
                   "editor/publishing",
                   "editor/git-concepts",
                   "editor/editor",

editor/branching-workflow.mdx renamed to editor/branches.mdx

@@ -1,7 +1,7 @@
 ---
 title: "Getting started with the web editor"
 sidebarTitle: "Getting started"
-description: "Learn how to use Mintlify's web editor to create and edit documentation"
+description: "Learn how to create and edit documentation with the web editor"
 ---
 
 <img
@@ -16,57 +16,58 @@ description: "Learn how to use Mintlify's web editor to create and edit document
   alt="Mintlify web editor interface in dark mode"
 />
 
-The web editor is a visual interface for creating, editing, and reviewing documentation directly in your browser. No local setup required—just log in to your dashboard and start writing.
+The web editor is a visual interface for creating, editing, and reviewing documentation directly in your browser.
 
-## What you can do
+- **Visual editing**: Make changes to your documentation using a what-you-see-is-what-you-get (WYSIWYG) editor that shows how your content will look when published.
+- **Git synchronization**: All changes automatically sync with your Git repository to maintain version control.
+- **Team collaboration**: Multiple people can work on documentation simultaneously.
+- **Component integration**: Add callouts, code blocks, and other components with slash commands.
+- **No setup required**: Start writing immediately from your dashboard.
 
-- **Visual editing**: Make changes using a what-you-see-is-what-you-get (WYSIWYG) editor that shows how your content will look when published
-- **Git synchronization**: All changes automatically sync with your Git repository to maintain version control
-- **Real-time collaboration**: Multiple team members can work on documentation simultaneously
-- **Component integration**: Add callouts, code blocks, and other Mintlify components with a simple `/` command
+## Web editor workflow
 
-## Your first editing session
-
-Follow this walkthrough to make your first changes in the web editor:
+Here is how you'll typically work in the web editor:
 
 <Steps>
   <Step title="Choose your branch">
-    Create a branch or make changes directly to your deployment branch. For your first time, we recommend creating a branch to keep your live docs safe while you learn.
+    Create a branch or make changes directly to your deployment branch. We recommend creating a branch so that you can preview your changes before they go live.
   </Step>
   <Step title="Open your file">
     Navigate to an existing file in the sidebar or create a new one using the file explorer.
   </Step>
   <Step title="Edit your content">
-    Make changes in the web editor. Try switching between visual mode and Markdown mode using the toggle in the top-right corner to see which you prefer.
+    Make changes in the web editor. Try switching between visual mode and Markdown mode using the toggle in the top-right corner to see which mode you prefer.
   </Step>
   <Step title="Preview your changes">
-    Visual mode shows you exactly how your changes will appear on your live site. Use this to verify everything looks correct.
+    Visual mode shows you how your changes will appear on your live site. Use this to verify everything looks correct.
   </Step>
   <Step title="Publish your changes">
-    If you're working on your deployment branch, your changes go live immediately. On other branches, you'll create a pull request for review before publishing.
+    If you're working on your deployment branch, publish your changes directly from the web editor. On other branches, you'll create a pull request for review before publishing.
   </Step>
 </Steps>
 
 ## Editor modes
 
-The web editor offers two editing experiences. Switch between them anytime using the toggle in the editor toolbar:
+The web editor has two modes to accommodate different editing preferences and needs. Use the toggle in the top right corner of the editor toolbar to switch between editing modes.
 
 <Frame>
   <img 
     src="/images/editor/mode-toggle-light.png" 
-    alt="Mode toggle icons highlighted in the Mintlify web editor" 
+    alt="Mode toggle icons highlighted in the web editor." 
     className="block dark:hidden"
   />
   <img 
     src="/images/editor/mode-toggle-dark.png" 
-    alt="Mode toggle icons highlighted in the Mintlify web editor" 
+    alt="Mode toggle icons highlighted in the web editor." 
     className="hidden dark:block"
   />
 </Frame>
 
 ### Visual mode
 
-Perfect for beginners and quick edits. What you see in the editor is exactly what appears on your documentation site. Press `/` to open the component menu and add content blocks, callouts, and code snippets.
+Visual mode provides a WYSIWYG experience where the changes that you make in the editor are the changes that will be published to your documentation site. This mode is ideal for when you want to see how your changes will look in real-time.
+
+Press `/` to open the component menu and add styled content, callouts, code snippets, or other components.
 
 <Frame>
   <img 
@@ -83,7 +84,7 @@ Perfect for beginners and quick edits. What you see in the editor is exactly wha
 
 ### Markdown mode
 
-Gives you direct access to the underlying MDX code. Use this when you need precise control over component properties or prefer writing in Markdown syntax.
+Markdown mode provides direct access to the underlying `MDX` code of your documentation. This mode is ideal for when you need precise control over component properties or when you prefer to write in Markdown syntax.
 
 <Frame>
   <img 
@@ -100,10 +101,6 @@ Gives you direct access to the underlying MDX code. Use this when you need preci
 
 ## Next steps
 
-Now that you understand the basics:
-
-- Learn about [branching workflows](/editor/branching-workflow) for safer collaboration
-- Explore [content management](/editor/content-management) techniques
-- Understand [publishing options](/editor/publishing) for different scenarios
-
-Need help? Check the [troubleshooting guide](/editor/troubleshooting) for common solutions.
+- Learn about collaborating with [branches](/editor/branches).
+- Explore [content management](/editor/content-management) techniques.
+- Understand [publishing options](/editor/publishing) for different scenarios.