Skip to content

Standardize writing style and tone across docs#141

Open
mintlify[bot] wants to merge 2 commits intomainfrom
mintlify/style-consistency-1776039635
Open

Standardize writing style and tone across docs#141
mintlify[bot] wants to merge 2 commits intomainfrom
mintlify/style-consistency-1776039635

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify bot commented Apr 13, 2026

Summary

Comprehensive style consistency pass across 115 MDX files to align with docs style guide.

Changes

  • Heading capitalization: Converted ~250 headings from title case to sentence case (e.g., "Getting Started" → "Getting started"), preserving proper nouns like Initia, Cosmos, EVM, IBC, OPinit
  • Second-person voice: Replaced first-person "we" (e.g., "we need to clone") with "you" or imperative voice in tutorial content
  • Third-person → second-person: Converted "users can", "the user", "a user's" to "you can", "your" in user-facing documentation
  • Active voice: Replaced passive constructions like "is recommended that you" → "you should", "can be found" → "you can find"
  • Terminology: Standardized "onchain" to "on-chain" and "app chains" to "appchains"

Not changed

  • Code blocks, command examples, API references, and frontmatter titles (unless explicitly inconsistent)
  • Technical content or meaning
  • Pre-existing parsing errors in initiadex.mdx and creating-move-coin.mdx

…-person voice, active voice

- Convert ~250 headings from title case to sentence case across 115 files
- Replace first-person 'we' with second-person 'you' in tutorial/guide content
- Convert third-person 'users/the user' to second-person 'you' in user-facing docs
- Fix passive voice to active voice where clarity improves
- Standardize 'onchain' to 'on-chain' and 'app chains' to 'appchains'

Generated-By: mintlify-agent
@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify bot commented Apr 13, 2026

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

Project Status Preview Updated (UTC)
initia-docs 🟢 Ready View Preview Apr 13, 2026, 12:29 AM

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.

1 participant