Fix Vale warnings from PRs merged in the last week

agent/workflows.mdx

@@ -161,7 +161,7 @@
 - `git` and the GitHub CLI (`gh`)
 - The Mintlify CLI (`mint`)
 - Node.js and Bun
 - **Web search** to find up-to-date information outside your documentation
 - **Web fetch** to retrieve and read the contents of a web page
 
 The agent cannot install additional packages or tools at runtime. Package registries are not reachable from the sandbox.
@@ -235,7 +235,7 @@
 
 ### Track translation lag
 
-**Trigger:** Cron schedule `0 9 * * 3` (Wednesdays at 9:00 AM UTC)
+**Trigger:** cron schedule `0 9 * * 3` (Wednesdays at 9:00 AM UTC)
 
 Update the example language subdirectories (`es/`, `fr/`, `zh/`) to your actual language subdirectories.
 
@@ -254,7 +254,7 @@
 
 ### SEO and metadata audit
 
-**Trigger:** Cron schedule `0 9 * * 1` (Mondays at 9:00 AM UTC)
+**Trigger:** cron schedule `0 9 * * 1` (Mondays at 9:00 AM UTC)
 
 ```text
 Audit all MDX files in the docs for SEO and metadata quality. Check for:
@@ -298,7 +298,7 @@
 
 ### Changelog with notifications
 
-**Trigger:** Cron schedule `0 9 * * 1` (Mondays at 9:00 AM UTC)
+**Trigger:** cron schedule `0 9 * * 1` (Mondays at 9:00 AM UTC)
 **Context repos:** `your-org/your-product`
 **Slack notifications:** `documentation` channel, `tech-writer` user
 

cli/commands.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Commands"
 description: "Complete reference for every Mintlify CLI command and flag, including mint dev, mint build, mint validate, mint analytics, and more."
 keywords: ["CLI", "mint", "commands", "flags", "reference"]
 ---
 
@@ -141,7 +141,7 @@
 | --- | --- |
 | `--page` | Filter conversations that reference a specific page in sources. |
 
 #### `mint analytics conversation view <conversation-id>`
 
 View a single conversation by ID. Use `mint analytics conversation list` to get IDs.
 
@@ -157,7 +157,7 @@
 mint analytics conversation buckets list
 ```
 
 #### `mint analytics conversation buckets view <bucket-id>`
 
 View conversations in a category bucket. Use `mint analytics conversation buckets list` to get IDs.
 
@@ -175,7 +175,7 @@
 mint config <subcommand> <key> [value]
 ```
 
 | Subcommand | Description |
 | --- | --- |
 | `set <key> <value>` | Set a configuration value. |
 | `get <key>` | Display a configuration value. |
@@ -242,7 +242,7 @@
 | `--local-schema` | Allow validation of locally hosted OpenAPI files served over HTTP. Only supports HTTPS in production. |
 
 <Note>
-  The standalone `mint openapi-check` command is deprecated. Use `mint validate` instead.
+  Mintlify deprecated the standalone `mint openapi-check` command. Use `mint validate` instead.
 </Note>
 
 ---
@@ -364,7 +364,7 @@
 
 ## Telemetry
 
 The CLI collects anonymous usage telemetry to help improve Mintlify. Telemetry data includes the command name, CLI version, operating system, and architecture. Mintlify does **not** collect personally identifiable information, project content, or file paths.
 
 By default, the CLI collects telemetry data. You can opt out at any time using the `--telemetry` flag:
 

guides/assistant-embed.mdx

@@ -5,7 +5,7 @@
 keywords: ["assistant embed", "in-app chat", "widget", "chatbot"]
 ---
 
-## What you will build
+## What you build
 
 A reusable widget that embeds the [assistant](/assistant/index) directly in your application. The widget provides:
 
@@ -73,7 +73,7 @@
 export const ASSISTANT_CONFIG = {
   domain: 'your-domain',
   docsURL: 'https://yourdocs.mintlify.app',
 };
 ```
 
 Replace:
@@ -117,12 +117,12 @@
     .map(source => ({
       url: source.url || source.path,
       title: source.metadata?.title || source.path,
     })) || [];
 };
 
 // In your message rendering:
 {messages.map((message) => {
   const sources = message.role === 'assistant' ? extractSources(message.parts) : [];
   return (
     <div key={message.id}>
       {/* message content */}
@@ -173,7 +173,7 @@
     }
   }, []);
 
   const { messages, input, handleInputChange, handleSubmit, isLoading } = useChat({
     api: `https://api.mintlify.com/discovery/v1/assistant/${domain}/message`,
     headers: {
       'Authorization': `Bearer ${import.meta.env.VITE_MINTLIFY_TOKEN}`,

guides/branches.mdx

@@ -8,7 +8,7 @@ Branches are a feature of version control that point to specific commits in your
 
 Branches let you create separate instances of your documentation to make changes, get reviews, and try new approaches before publishing. Your team can work on branches to update different parts of your documentation simultaneously without affecting what users see on your live site.
 
-The following diagram shows an example of a branch workflow where a feature branch is created, changes are made, and then the feature branch is merged into the main branch.
+The following diagram shows an example of a branch workflow where someone creates a feature branch, makes changes, and then merges the feature branch into the main branch.
 
 ```mermaid
 gitGraph