#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 EvilDMP):
Replying to [comment:7 jdufresne]:
> > When we refer to a field or its contents in writing, it's perfectly
normal to capitalise the name of the field. The same goes for the names of
menus, buttons and so on.
>
> Just to be clear, are you arguing that it is *ideal* that the field name
is capitalized in the middle of the sentence or merely arguing that it is
acceptable and wish to take no action out of convenience?
I think it would be positively '''incorrect''' not to capitalise such
special names in a case like this.
It would look rather stilted if every time we referred to a person as
'Person', and not even helpful, but when we are explicitly referring to
the model for a person ''in the system'', capitalising it signals that it
has a special status. This is one of those cases.
It's not just a tradition in software documentation; you'll see it in
legal documentation too.
I am against the proposal to change the current behaviour because I think
it will reduce the clarity of error messages. I would be in favour of
rewording the error message to make it clearer.
--
Ticket URL: <https://code.djangoproject.com/ticket/22716#comment:8>
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.75d946ddc9bdf35e20a6efac32631d6f%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.
