Skip to content

Fix writing style and tone inconsistencies#2466

Open
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/style-consistency-1776283399
Open

Fix writing style and tone inconsistencies#2466
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/style-consistency-1776283399

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented Apr 15, 2026

Summary

Fixes style inconsistencies found during a docs-wide audit for voice, tone, and formatting consistency.

Changes

Heading capitalization (title case → sentence case):

  • weave/guides/evaluation/scorers.mdx: "Scoring Overview" → "Scoring overview"
  • weave/guides/tools.mdx: "Tools & Utilities" → "Tools and utilities"
  • weave/guides/platform/weave-projects.mdx: "Manage Weave Projects" → "Manage Weave projects"
  • weave/guides/integrations/js.mdx: "TypeScript SDK: Third-Party Integration Guide" → "TypeScript SDK: third-party integration guide"
  • training/api-reference.mdx: "API Overview" → "API overview"
  • platform/hosting/enterprise-licenses.mdx: "Enterprise Licenses" → "Enterprise licenses"

Gerund headings → imperative verbs in weave/guides/tracking/costs.mdx:

  • "Adding a custom cost" → "Add a custom cost"
  • "Querying for costs" → "Query for costs"
  • "Purging a custom cost" → "Purge a custom cost"
  • "Calculating costs for a Project" → "Calculate costs for a project"
  • "Setting up a custom model with custom costs" → "Set up a custom model with custom costs"

Passive voice → active voice across training section:

  • Rewrote overview paragraphs from third-person product-as-subject ("Serverless RL helps developers...") to second-person imperative ("Use Serverless RL to...")
  • Converted passive constructions ("are automatically stored", "can be accessed", "is supported", "are charged", "is billed") to active voice

Typos fixed:

  • "exterrnal" → "external" (audit-logging.mdx)
  • "the your companies" → "your company's" (manage-organization.mdx)
  • "posses" → "possess" (manage-organization.mdx)
  • "organzation's" → "organization's" (secure-storage-connector.mdx)
  • "inper" → "in per-million-token units" (costs.mdx)

Other style fixes:

  • Removed duplicate "Available Endpoints" section in api-reference.mdx
  • Replaced "e.g." with "for example" (costs.mdx)
  • Removed exclamation points in "Stay tuned!" (costs.mdx)

- Fix sentence case in page titles: Scoring Overview, Tools & Utilities,
  Manage Weave Projects, TypeScript SDK integration guide, API Overview,
  Enterprise Licenses
- Convert passive voice to active voice in training section pages
- Replace gerund headings with imperative verbs in costs.mdx
- Fix typos: exterrnal, posses, organzation's, the your companies, inper
- Remove duplicate Available Endpoints section in api-reference.mdx
- Replace Latin abbreviation (e.g.) with plain English
- Remove exclamation points per style guide

Generated-By: mintlify-agent
@mintlify mintlify Bot requested a review from a team as a code owner April 15, 2026 20:09
@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented Apr 15, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
wandb 🟢 Ready View Preview Apr 15, 2026, 8:12 PM

@github-actions
Copy link
Copy Markdown
Contributor

📚 Mintlify Preview Links

🔗 View Full Preview

📝 Changed (17 total)

📄 Pages (17)

File Preview
platform/hosting/data-security/secure-storage-connector.mdx Secure Storage Connector
platform/hosting/enterprise-licenses.mdx Enterprise Licenses
platform/hosting/iam/access-management/manage-organization.mdx Manage Organization
platform/hosting/monitoring-usage/audit-logging.mdx Audit Logging
training.mdx Training
training/api-reference.mdx Api Reference
training/serverless-rl.mdx Serverless Rl
training/serverless-rl/serverless-rl.mdx Serverless Rl
training/serverless-rl/usage-limits.mdx Usage Limits
training/serverless-rl/use-trained-models.mdx Use Trained Models
... and 7 more files

🤖 Generated automatically when Mintlify deployment succeeds
📍 Deployment: c2203e6 at 2026-04-15 20:12:48 UTC

@github-actions
Copy link
Copy Markdown
Contributor

🔗 Link Checker Results

All links are valid!

No broken links were detected.

Checked against: https://wb-21fd5541-mintlify-style-consistency-1776283399.mintlify.app

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants