#7956: Grammar in the tutorial
------------------------------------+---------------------------------------
Reporter: tmorgan | Owner: nobody
Status: closed | Milestone:
Component: Documentation | Version: SVN
Resolution: invalid | Keywords: grammar, will
Stage: Unreviewed | Has_patch: 0
Needs_docs: 0 | Needs_tests: 0
Needs_better_patch: 0 |
------------------------------------+---------------------------------------
Changes (by durdinator):
* status: new => closed
* needs_better_patch: => 0
* resolution: => invalid
* needs_tests: => 0
* needs_docs: => 0
Comment:
I'm not sure where you've picked up this idea that '"will" should only be
used with a specific time qualifier'. This usage may be preferred by some
editors, but to call it an error--implying ungrammatical--is clearly
nonsense, as any English speakers 3 years old or more could tell you. Nor
is your advice itself consistent: you give "When the clock strikes twelve,
the bell will ring" as an example you call 'correct', but you reject 'When
somebody requests a page from your Web site — say, “/polls/23/”, Django
will load this Python module' which is an identical construction.
I will clarify that I'm not complaining about your suggested changes being
ungrammatical; they are clearly also grammatical. But I'm not convinced
that anything needs changing in the tutorial. The examples you've
highlighted--as you yourself pointed out--can be understood by anyone. The
use of "will" here doesn't make the examples ambiguous, awkward, nor even
particularly verbose, so nothing needs to be changed.
So I'm going to close this as invalid. If you find any actual errors,
amibiguities, clumsy wording, needlessly verbose text, or other such
issues that hinder the clarity of the tutorial, please raise a ticket with
a patch or a suggested correction. But pet style hates don't belong.
--
Ticket URL: <http://code.djangoproject.com/ticket/7956#comment:1>
Django Code <http://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 post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at
http://groups.google.com/group/django-updates?hl=en
-~----------~----~----~----~------~----~------~--~---
