Opened 9 years ago

Closed 9 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 marton bognar)

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 marton bognar, 9 years ago

Description: modified (diff)

comment:2 by marton bognar, 9 years ago

Another solution to reduce ambiguity could be to use the term "how-to guides", as it is used in other places in the documentation.

comment:3 by Tim Graham, 9 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.

Note: See TracTickets for help on using tickets.
Back to Top