Update docs upon changes to Bruno: WYSIWYG docs editor & variable sort/DnD

api-docs/overview.mdx

@@ -5,8 +5,17 @@
 
 Bruno allows you to create API documentation at four distinct levels: **Workspace, Collection, Folder, and Request**.
 
 With full Markdown support you can write clear, concise, and well-structured documentation at each level supplemented with any relevant screenshots, gifs, or other elements to ensure your users have a seamless onboarding experience.
 
+## Rich Text and Markdown Editing
+
+The Docs tab includes a WYSIWYG (rich text) editor built on top of Markdown. You can:
+
+- Format text visually using a toolbar (headings, bold, italic, lists, task lists, tables, links, images, code blocks, undo/redo).
+- Toggle between **Rich Text** and **Markdown** modes at any time using the mode switch — content stays synchronized because Markdown remains the underlying source of truth.
+
+This lets non-technical teammates author documentation without writing raw Markdown, while power users can still edit Markdown directly.
+
 <Info>
   Bruno sanitizes all HTML in documentation blocks before rendering. This prevents cross-site scripting (XSS) attacks when previewing markdown that contains embedded HTML. Elements like `script` tags and inline event handlers are automatically removed.
 </Info>

api-docs/request-docs.mdx

@@ -12,10 +12,16 @@ In Bruno, you can create Request-level documentation to provide specific details
 ![request-level-edit-docs](/images/screenshots/send-request/api-docs/req-docs-tab.webp)
 
 2. Click the **Edit** button.
-3. Enter your API details in the provided textarea.
+3. Enter your API details in the editor.
 
 ![request-level-edit-docs](/images/screenshots/send-request/api-docs/request-level-edit-docs.webp)
 
 4. Click the **Preview** button to see the formatted output.
 
 ![request-level-preview-docs](/images/screenshots/send-request/api-docs/request-level-preview-docs.webp)
+
+## Rich Text and Markdown Editing
+
+The request Docs editor supports both **Rich Text (WYSIWYG)** and **Markdown** modes. Use the mode switch in the toolbar to toggle between them at any time — content stays in sync because Markdown remains the underlying source of truth.
+
+In Rich Text mode you can use the toolbar to add headings, bold and italic text, lists, task lists, tables, links, images, and code blocks, and to undo or redo changes without writing raw Markdown.

variables/overview.mdx

@@ -151,6 +151,15 @@ In the Vars tab you can select the type of each variable using the type dropdown
   **Backward compatibility:** Existing `.bru` files and environments that use plain string values continue to work without any changes or migration. The `@type(...)` annotation is only written when a non-string type is used.
 </Note>
 
+### Sorting and Reordering Variables
+
+You can control the order in which variables appear in the Vars tab across all scopes (collection, folder, request, and environment).
+
+- **Alphabetical sort:** Use the sort control in the Vars tab to sort variables **A–Z** or **Z–A**. Sort preference persists across sessions.
+- **Drag-and-drop reordering:** In **Manual** mode, use the drag handle on each row to reorder variables. The saved order is written back to the underlying file after you save.
+
+Sorting and reordering preserve variable group boundaries (for example, secret and non-secret groups) and keep newly added rows in place.
+
 ### Environment Color Coding
 
 <Info>