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

Improve example table for homonyms #568

Open
daobrien opened this issue Mar 28, 2024 · 0 comments
Open

Improve example table for homonyms #568

daobrien opened this issue Mar 28, 2024 · 0 comments
Labels
impediment Not really a bug but annoying.

Comments

@daobrien
Copy link
Collaborator

https://stylepedia.net/style/6.2/#avoiding-ambiguities
Table 4.7.

The following is given as an example:
Tab through the dialog box. Set the tab. Move the tab on the ruler. How to show or hide tabs. Select the tab.

tbh it's not clear if that's supposed to be a single example or multiple examples of how "tab" can be used, or misused. ("Tab" as a verb is not valid in our vocab.)

The "improvement" in the second column suffers from the same issue.

A lot of the language also contradicts the guide's own advice. E.g., we don't write "Select the View tab."

I also don't think the second row is a good example of homonymity.

@daobrien daobrien added the impediment Not really a bug but annoying. label Mar 28, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
impediment Not really a bug but annoying.
Projects
None yet
Development

No branches or pull requests

1 participant