Skip to content

Add clause to etiquette about using English#1060

Merged
apiraino merged 2 commits into
rust-lang:masterfrom
apiraino:add-clause-to-use-english
Jun 4, 2026
Merged

Add clause to etiquette about using English#1060
apiraino merged 2 commits into
rust-lang:masterfrom
apiraino:add-clause-to-use-english

Conversation

@apiraino
Copy link
Copy Markdown
Contributor

@apiraino apiraino commented Jun 3, 2026

Discussed on Zulip.

Open to reword that sentence (I am not English mother-tongue 😉 )

r? @jieyouxu

Rendered

@rustbot rustbot added the S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. label Jun 3, 2026
@apiraino apiraino enabled auto-merge (squash) June 3, 2026 13:18
@apiraino apiraino force-pushed the add-clause-to-use-english branch from b222052 to 615284f Compare June 3, 2026 13:19
@rustbot
Copy link
Copy Markdown
Collaborator

rustbot commented Jun 3, 2026

This PR was rebased onto a different master commit. Here's a range-diff highlighting what actually changed.

Rebasing is a normal part of keeping PRs up to date, so no action is needed—this note is just to help reviewers.

Comment thread src/how-to-start-contributing.md Outdated
- If you want to fix an issue but have doubts about the design, you're welcome to join our [Zulip][rust-zulip] server and ask for tips
- Please respect the reviewers' time: allow some days between reviews, only ask for reviews when your code compiles and tests pass, or give an explanation for why you are asking for a review at that stage (you can keep them in draft state until they're ready for review)
- Try to keep comments concise, don't worry about a perfect written communication. Strive for clarity and being to the point
- We prefer using the English language to follow conventions of existing commits. Again, don't worry about writing a perfect prose
Copy link
Copy Markdown
Member

@jieyouxu jieyouxu Jun 3, 2026

Choose a reason for hiding this comment

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

Suggestion: I might say sth like

  • Please use English to communicate (including e.g. commit messages). The grammar or prose does not need to be perfect at all!
    • This is because contributors come from all over the world, so a common language is needed to communicate. The lingua franca happens to be English1.

I kinda want to balance between being to-the-point (concise) and giving some context on why. I think this should also point to the machine translation note if the Forge policy is accepted 2.

Footnotes

  1. With all the caveats of "there isn't a single The English Language"

  2. We should probably have a specific page about how to share translated messages more effectively (e.g. include the original language too).

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

in commit 3faa350 I'm trying a shorter version of your suggestion, wdyt?

(condensing text is hard)

@apiraino apiraino requested a review from jieyouxu June 3, 2026 15:29
Copy link
Copy Markdown
Member

@jieyouxu jieyouxu left a comment

Choose a reason for hiding this comment

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

Thanks, this seems like a reasonable wording

View changes since this review

@apiraino apiraino merged commit ee45ff3 into rust-lang:master Jun 4, 2026
1 check passed
@rustbot rustbot removed the S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. label Jun 4, 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.

3 participants