#23762: docs: fix markdown formatting and structure issues
docs
channel: bluebubbles
size: XS
## Summary
- **VISION.md**: Use H1 for document title; add blank line and bullet list for cross-reference links
- **CONTRIBUTING.md**: Rename duplicate `## Maintainers` heading to `## Becoming a Maintainer`
- **grammy.md**: Demote extra H1 headings to H2; add missing `##` prefix on "Open questions"
- **bluebubbles.md**: Consolidate duplicate "Typing indicators" bullet into one
- **platforms/index.md**: Remove redundant sentence about Windows companion apps
## Test plan
- [x] Verify docs render correctly on Mintlify
<!-- greptile_comment -->
<h3>Greptile Summary</h3>
This PR fixes markdown formatting and structure issues across 5 documentation files. All changes are formatting-only and improve document structure:
- `VISION.md`: Changed document title from H2 to H1 (`#` instead of `##`), added blank line for better separation, converted cross-reference links to a proper bullet list
- `CONTRIBUTING.md`: Renamed duplicate "Maintainers" heading to "Becoming a Maintainer" to distinguish it from the existing maintainer list section
- `grammy.md`: Demoted extra H1 headings to H2 for proper hierarchy ("Why grammY", "What we shipped"), added missing `##` prefix to "Open questions"
- `bluebubbles.md`: Consolidated duplicate "Typing indicators" bullet points into a single comprehensive entry
- `platforms/index.md`: Removed redundant sentence about Windows companion apps (was mentioned twice with slightly different wording)
All changes follow proper markdown conventions and improve documentation clarity without altering any technical content.
<h3>Confidence Score: 5/5</h3>
- This PR is safe to merge with no risk
- All changes are purely cosmetic markdown formatting fixes with no impact on functionality, logic, or behavior. The changes improve document structure and readability by fixing heading levels, removing duplicates, and organizing content properly. No code or configuration is modified.
- No files require special attention
<sub>Last reviewed commit: e36cf3c</sub>
<!-- greptile_other_comments_section -->
<sub>(4/5) You can add custom instructions or style guidelines for the agent [here](https://app.greptile.com/review/github)!</sub>
<!-- /greptile_comment -->
Most Similar PRs
#23770: docs: fix broken URL, inconsistent casing, and hyphenation
by jainilDesai · 2026-02-22
81.8%
#7210: docs: cleanup citation artifacts and update twitter URLs to X
by hongxuWei · 2026-02-02
79.5%
#13819: docs: fix FAQ heading punctuation
by eliaseffects · 2026-02-11
78.6%
#11048: fix: address repository issues (env, author, CI comments, security ...
by cavula · 2026-02-07
78.4%
#15530: docs(web_fetch): document markdown-first Accept header and cf-markd...
by novavale · 2026-02-13
78.1%
#23757: docs: replace outdated legacy names and paths
by jainilDesai · 2026-02-22
78.1%
#10894: Docs: fix legacy branding, add config reference, expand cron troubl...
by biv0711 · 2026-02-07
77.8%
#7487: docs: add code review for recent security commits (b796f6e..411d5fd)
by INTEGRITY2077 · 2026-02-02
76.7%
#16362: Update session-pruning.md - updated agents.defaults config std
by elliottb · 2026-02-14
76.7%
#8509: docs: add docs CONTRIBUTING.md
by ethanpalm · 2026-02-04
76.6%