Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

MINOR: [Format] Schema.fbs grammar -- improve Map key/value field docs readability #45024

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

akesling
Copy link
Contributor

Rationale for this change

To improve a comment.

What changes are included in this PR?

Improvement to the Map key/value field docs readability.

Are these changes tested?

N/A

Are there any user-facing changes?

No

@github-actions github-actions bot added the awaiting review Awaiting review label Dec 13, 2024
@kou kou changed the title MINOR: Schema.fbs grammar -- improve Map key/value field docs readability MINOR: [Format] Schema.fbs grammar -- improve Map key/value field docs readability Dec 18, 2024
/// has two children: key type and the second the value type. The names of the
/// child fields may be respectively "entries", "key", and "value", but this is
/// not enforced.
/// has two children: the first of the key type and second of the value type.
Copy link
Member

Choose a reason for hiding this comment

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

I'm not good at English but we don't need one more the?

Suggested change
/// has two children: the first of the key type and second of the value type.
/// has two children: the first of the key type and the second of the value type.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

It works grammatically either way, but the extra "the" isn't strictly necessary. Definite articles often need not be repeated in lists. I, personally, prefer the shorter form but defer to maintainers.

See https://english.stackexchange.com/questions/178767/definite-article-repetition-in-lists for a spot of context.

Copy link
Member

Choose a reason for hiding this comment

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

OK. I'll merge this PR in the next week if nobody objects this PR.

@github-actions github-actions bot added awaiting changes Awaiting changes and removed awaiting review Awaiting review labels Dec 18, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
awaiting changes Awaiting changes
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants