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 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, 7 years ago

Description: modified (diff)

comment:2 by marton bognar, 7 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, 7 years ago

Resolution: wontfix
Status: newclosed
Type: UncategorizedCleanup/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