Opened 7 years ago
Closed 7 years ago
#29233 closed Cleanup/optimization (wontfix)
Proposing to change the spelling of "how-to's"
Reported by: | marton bognar | Owned by: | nobody |
---|---|---|---|
Component: | Documentation | Version: | 2.0 |
Severity: | Normal | Keywords: | |
Cc: | Triage Stage: | Unreviewed | |
Has patch: | no | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | no |
Easy pickings: | yes | UI/UX: | yes |
Description (last modified by )
In English grammar apostrophes should not be used to make regular nouns plural (Rule 2b.). In the current documentation (at least in some places, including the default screen for new Django installations) the word is written as "how-to's" instead of the form "how-tos". One could argue whether "how-to" is a regular noun, but I think in this case more confusion can stem from the usage of the first form than the second.
I will gladly create a PR for this issue if you agree with me, but I'm not sure whether the locale message id (msgid "Topics, references, & how-to's") should be changed as well or preserved in the current form for possible legacy reasons.
Change History (3)
comment:1 by , 7 years ago
Description: | modified (diff) |
---|
comment:2 by , 7 years ago
comment:3 by , 7 years ago
Resolution: | → wontfix |
---|---|
Status: | new → closed |
Type: | Uncategorized → Cleanup/optimization |
Thanks for the proposal, but I think it's fine as is. Both forms are acceptable and changing it at this point will cause extra work for documentation translators.
Another solution to reduce ambiguity could be to use the term "how-to guides", as it is used in other places in the documentation.