Skip to content

Style: convert formal language to informal contractions in documentation#5461

Open
Copilot wants to merge 9 commits intomainfrom
copilot/update-informal-language-in-docs
Open

Style: convert formal language to informal contractions in documentation#5461
Copilot wants to merge 9 commits intomainfrom
copilot/update-informal-language-in-docs

Conversation

Copy link
Contributor

Copilot AI commented Feb 5, 2026

Summary

Converted formal language constructs to contractions across documentation to improve approachability. Systematically replaced 17 patterns ("you are" → "you're", "do not" → "don't", "cannot" → "can't", etc.) in 445 markdown files while preserving code blocks, inline code, and formal historical documentation (changelogs, release notes).

Key changes:

  • Automated pattern-based conversion preserving capitalization and context
  • Excluded code blocks (``` fences and inline backticks) from transformation
  • Excluded docs/whats-new/changelog/ and docs/cloud/reference/*/changelog/ directories
  • Fixed anchor IDs in docs/guides/troubleshooting.md (removed apostrophes from {#can't-*}{#cant-*})

Checklist


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

@vercel
Copy link

vercel bot commented Feb 5, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
clickhouse-docs Ready Ready Preview Feb 12, 2026 3:48am
2 Skipped Deployments
Project Deployment Actions Updated (UTC)
clickhouse-docs-ru Ignored Ignored Preview Feb 12, 2026 3:48am
clickhouse-docs-zh Ignored Ignored Preview Feb 12, 2026 3:48am

Request Review

@CLAassistant
Copy link

CLAassistant commented Feb 5, 2026

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
2 out of 3 committers have signed the CLA.

✅ Blargian
✅ dhtclk
❌ Copilot
You have signed the CLA already but the status is still pending? Let us recheck it.

Copilot AI and others added 3 commits February 5, 2026 12:21
Co-authored-by: Blargian <41984034+Blargian@users.noreply.github.com>
Co-authored-by: Blargian <41984034+Blargian@users.noreply.github.com>
Co-authored-by: Blargian <41984034+Blargian@users.noreply.github.com>
Copilot AI changed the title [WIP] Update documentation for informal language usage Convert formal language to informal contractions in documentation Feb 5, 2026
Copilot AI requested a review from Blargian February 5, 2026 12:27
Copy link
Member

@Blargian Blargian left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great job @copilot, you saved me about 2 days of absolute misery!

@Blargian Blargian marked this pull request as ready for review February 5, 2026 18:08
@Blargian Blargian requested review from a team as code owners February 5, 2026 18:08
@Blargian Blargian changed the title Convert formal language to informal contractions in documentation Style: convert formal language to informal contractions in documentation Feb 5, 2026
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.

4 participants