Skip to content

Apply brand tone and writing style fixes#6720

Merged
ethanpalm merged 3 commits into
mainfrom
mintlify/b5043a57
Jul 24, 2026
Merged

Apply brand tone and writing style fixes#6720
ethanpalm merged 3 commits into
mainfrom
mintlify/b5043a57

Conversation

@mintlify

@mintlify mintlify Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Summary

Minor style and tone fixes across the SDK reference documentation added in #6717 so the new pages match the predominant voice in the repo.

Changes

  • api-playground/adding-sdk-examples.mdx: tightened the opening sentence (was 33 words) and replaced weak "Here is an example" phrasing with active voice.
  • api-playground/sdk-reference-setup.mdx: split a 39-word sentence in "Keep references up to date" into two shorter sentences.
  • integrations/sdks/speakeasy.mdx: swapped "Navigate to" for "Go to" to match the predominant verb used elsewhere for dashboard navigation.
  • automations/reference.mdx: split a 32-word sentence about support platform selection into two sentences for readability.

No headings, code samples, technical details, or API references were changed.


Note

Low Risk
Copy-only documentation changes with no code, config, or API behavior impact.

Overview
Documentation-only edits align newer SDK reference and related pages with the repo’s voice: shorter sentences, active phrasing, and consistent dashboard navigation wording.

SDK and API playground (adding-sdk-examples.mdx, sdk-reference-setup.mdx, speakeasy.mdx): the x-codeSamples intro is tightened; example lead-ins use active voice instead of “Here is an example”; the CI “keep references up to date” paragraph is split into two sentences; Speakeasy setup uses Go to instead of Navigate to for the dashboard step.

Automations and self-host (automations/reference.mdx, deploy/self-host.mdx): long sentences on support-platform setup and Git proxy / sizing are broken up for readability without changing headings, samples, or technical details.

Reviewed by Cursor Bugbot for commit 324293c. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Jul 24, 2026, 1:01 AM

@mintlify

mintlify Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
tomee 🟢 Ready View Preview Jul 24, 2026, 1:01 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@ethanpalm
ethanpalm merged commit 629f648 into main Jul 24, 2026
6 checks passed
@ethanpalm
ethanpalm deleted the mintlify/b5043a57 branch July 24, 2026 18:35
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.

2 participants