copyedit content management page

Author: ethanpalm

editor/content-management.mdx

@@ -3,21 +3,17 @@ title: "Managing content"
 description: "Create, edit, and organize your documentation pages"
 ---
 
-Use the web editor to create new pages, edit existing content, and organize your documentation structure.
-
 ## Navigating your files
 
-### File explorer
 Use the sidebar file explorer to browse your documentation files. Click on any file to open it in the editor.
 
-### Quick file search
-Press <kbd>Command</kbd> + <kbd>P</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>P</kbd> (Windows) to quickly search and open files by name.
+Press <kbd>Command</kbd> + <kbd>P</kbd> (<kbd>Ctrl</kbd> + <kbd>P</kbd> on Windows) to search for files by name.
 
 ## Creating new pages
 
 <Steps>
-  <Step title="Open the file menu">
-    Select the **Create a new file** icon (+ symbol) in the file explorer sidebar.
+  <Step title="Create a new file">
+    Select the **Create a new file** icon in the file explorer sidebar.
 
     <img
       src="/images/editor/files-menu-light.png"
@@ -36,68 +32,24 @@ Press <kbd>Command</kbd> + <kbd>P</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>P</kbd
       }}
       alt="Files menu in the web editor in dark mode"/>
   </Step>
-  <Step title="Name your file">
-    Enter a filename ending in `.mdx` (for example: `api-reference.mdx` or `getting-started.mdx`).
+  <Step title="Enter a filename">
+    Filenames must end in `.mdx`. For example, `api-reference.mdx` or `getting-started.mdx`.
   </Step>
   <Step title="Create and open">
-    Press <kbd>Enter</kbd> to create the file. It will open automatically in the editor, ready for content.
+    Press <kbd>Enter</kbd> to create the file. It will open automatically in the editor, ready for content to be added.
   </Step>
 </Steps>
 
-Your new page needs frontmatter (metadata) at the top to display properly. Add this structure:
-
-```yaml
----
-title: "Your page title"
-description: "Brief description for SEO and navigation"
----
-```
-
-## Editing content
-
-### Using visual mode
-
-Visual mode shows you exactly how your content will appear on your documentation site. It's perfect for:
-
-- Writing and formatting text
-- Adding images and media
-- Creating lists and tables
-- Inserting components without knowing the syntax
-
-**Adding components**: Press <kbd>/</kbd> to open the component menu. Choose from callouts, code blocks, accordions, and other Mintlify components.
-
-<Frame>
-  <img 
-    src="/images/editor/component-menu-light.png" 
-    alt="The unfurled component menu emphasized in the Mintlify web editor" 
-    className="block dark:hidden" 
-  />
-  <img 
-    src="/images/editor/component-menu-dark.png" 
-    alt="The unfurled component menu emphasized in the Mintlify web editor" 
-    className="hidden dark:block" 
-  />
-</Frame>
-
-### Using Markdown mode
-
-Markdown mode gives you direct access to the MDX source code. Use this when you need to:
-
-- Set specific component properties
-- Work with complex nested components  
-- Copy and paste MDX content from other sources
-- Fine-tune formatting and spacing
-
 ## Organizing your navigation
 
-Add new pages to your site navigation by editing the `docs.json` file:
+Add new pages to your site navigation by editing your `docs.json` file.
 
 <Steps>
   <Step title="Open docs.json">
     Find and open the `docs.json` file in your root directory using the file explorer.
   </Step>
   <Step title="Locate the navigation section">
-    Find the `navigation` property in the JSON structure.
+    Find the spot in the `docs.json` file where you want to add your new page.
   </Step>
   <Step title="Add your page">
     Insert your page filename (without the `.mdx` extension) in the appropriate group's `pages` array.
@@ -132,21 +84,27 @@ Add new pages to your site navigation by editing the `docs.json` file:
 }
 ```
 
-See the [Navigation](/navigation) documentation for advanced navigation options.
+## Editing content
+
+Make changes to your pages using visual mode or Markdown mode in the editor.
 
-## Content best practices
+In visual mode, press <kbd>/</kbd> to open the component menu. Add content blocks, callouts, code blocks, and other components to customize your documentation.
 
-### Writing effective titles and descriptions
-- **Title**: Be specific and descriptive
-- **Description**: Write 1-2 sentences explaining what users will learn or accomplish
+<Frame>
+  <img 
+    src="/images/editor/component-menu-light.png" 
+    alt="The unfurled component menu emphasized in the Mintlify web editor" 
+    className="block dark:hidden" 
+  />
+  <img 
+    src="/images/editor/component-menu-dark.png" 
+    alt="The unfurled component menu emphasized in the Mintlify web editor" 
+    className="hidden dark:block" 
+  />
+</Frame>
 
-### Structuring your content
-- Start with the most important information
-- Use headings to break up long sections
-- Include examples and code snippets where helpful
-- End with next steps or related links
+In Markdown mode, you can directly edit the `MDX` of your pages. This can be helpful when you need to:
 
-### File organization
-- Group related pages in folders (like `/api/` or `/guides/`)
-- Use consistent naming conventions
-- Keep filenames short but descriptive
+- Set specific component properties
+- Work with complex nested components
+- Copy and paste `MDX` content from other sources