Skip to content

Conversation

@devin-ai-integration
Copy link
Contributor

Fix sentence case in titles and headings

Summary

Fixed remaining title case issues in documentation page titles to align with the sentence case style guide. Changed titles in 16 files across AsyncAPI, OpenAPI, OpenRPC, gRPC, and Fern Definition documentation sections.

Changed patterns:

  • "Parameter Names" → "Parameter names"
  • "Specification" → "specification" (in automation/overview pages)
  • "Error Handling" → "Error handling"
  • "Global Configuration" → "Global configuration"
  • "Binary Data and Files" → "Binary data and files"
  • "Multipart File Upload" → "Multipart file upload"
  • "Server-Sent Events and Streaming APIs" → "Server-sent events and streaming APIs"

These changes ensure consistency with the Vale Headings.yml style rules. Proper nouns and exceptions listed in Vale (like "Fern Definition", "OpenAPI", "AsyncAPI") were correctly left unchanged.

Review & Testing Checklist for Human

  • Verify the documentation site renders correctly at the affected pages (spot check 3-4 pages)
  • Confirm Vale CI checks pass
  • Check that navigation/table of contents displays the new titles correctly

Notes

  • All changes are in the title: frontmatter field of MDX files only
  • No functional code changes
  • Some trailing whitespace was cleaned up automatically

Link to Devin run: https://app.devin.ai/sessions/e564951caba34b7f92ac3936e5efa42a
Requested by: Devin Logan ([email protected]) (@devalog)

- Changed 'Parameter Names' to 'Parameter names' in AsyncAPI and OpenRPC parameter-names.mdx files
- Changed 'Specification' to 'specification' in all automation and overview page titles (AsyncAPI, OpenAPI, OpenRPC, gRPC)
- Changed 'Error Handling' to 'Error handling' in gRPC errors.mdx
- Changed 'Global Configuration' to 'Global configuration' in Fern Definition global-configuration.mdx
- Changed 'Binary Data and Files' to 'Binary data and files' in Fern Definition bytes.mdx
- Changed 'Multipart File Upload' to 'Multipart file upload' in Fern Definition and OpenAPI multipart.mdx files
- Changed 'Server-Sent Events and Streaming APIs' to 'Server-sent events and streaming APIs' in Fern Definition and OpenAPI sse.mdx files

Co-Authored-By: Devin Logan <[email protected]>
@devin-ai-integration
Copy link
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@github-actions
Copy link
Contributor

@devalog devalog merged commit bcc80ad into main Oct 24, 2025
2 checks passed
@devalog devalog deleted the devin/1761330666-fix-sentence-case-titles branch October 24, 2025 18:37
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