#22716: The unique error message uses incorrect grammar
-------------------------------+--------------------------------------
Reporter: jdufresne | Owner: nobody
Type: Uncategorized | Status: closed
Component: Uncategorized | Version: 1.6
Severity: Normal | Resolution: invalid
Keywords: | Triage Stage: Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------+--------------------------------------
Comment (by jdufresne):
> However in the context of a report such as this about the operation of a
system where Email is a something like a proper noun, it's OK, and it
helps signal that the thing we're speaking of is a special thing in the
system.
I admit, I do no have perfect grammar. Nor do I have any particular style
guide memorized. But, this usage is not a proper noun. I believe it is
incorrect to claim it is. The current capitalization just looks odd to me
as a native English speaker. Think about other ways you could use a model
(person) and field name (first name):
* Please enter your First name. (capitalization looks odd)
* What is your First name? (capitalization looks odd)
* Person with First name already exists. (capitalization looks odd)
* Search by First name. (capitalization looks odd)
* His First name is "Jon". (capitalization looks odd)
In English, you would never normally write first name in this manner. If
you want to emphasis the field name in the sentence, why not simply do
that? Quote it, italicize it, bold it, mono-space-font it, or whatever.
In other words, why is the field name forced to be capitalized? I want to
use it in a sentence with correct casing.
> You'll also often find technical documentation written this way, for
example.
Do you have an actual example? Is there a well regarded style guide that
recommends spelling field names with capital letters in documentation?
--
Ticket URL: <https://code.djangoproject.com/ticket/22716#comment:2>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/067.202fa1296c4935c3831413a51fc13a88%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.
