[Django] #21035: Assume "Ess queue ell" rather than "sequel" for in Django code and docs
Django
--------------------------------------+------------------------------
Reporter: EvilDMP | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: master
Severity: Normal | Keywords: afraid-to-commit
Triage Stage: Unreviewed | Has patch: 0
Easy pickings: 1 | UI/UX: 0
--------------------------------------+------------------------------
"Ess queue ell" rather than "sequel" should be preferred because:
* it's more obvious to non-native English speakers
* it's more commonly used
So we need to:
* note this in "Commonly used terms" in writing-documentation.txt
* find and change existing instances of "a SQL" to "an SQL" throughout
Django code and docs (both are currently used)
I would like to reserve this ticket for first-time committers who take
part in the [http://www.djangocon.us/schedule/presentation/7/ Don't be
afraid to commit tutorial] and the sprints at [http://djangocon.us/
DjangoCon US 2013] in September. However, if you want to tackle this
ticket before then, please don't hesitate. Feel free to re-assign it to
yourself and do whatever you like to it.
--
Ticket URL: <https://code.djangoproject.com/ticket/21035>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
Django
--------------------------------------+------------------------------------
Reporter: EvilDMP | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: master
Keywords: afraid-to-commit | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0
Changes (by EvilDMP):
* needs_docs: => 0
* needs_better_patch: => 0
* stage: Unreviewed => Accepted
* needs_tests: => 0
--
Ticket URL: <https://code.djangoproject.com/ticket/21035#comment:1>
Django
--------------------------------------+------------------------------------
Reporter: EvilDMP | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: master
Keywords: afraid-to-commit | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Easy pickings: 1 | UI/UX: 0
Comment (by mjtamlyn):
I'm unconvinced about "an SQL"... In believed that abbreviations should
take a/an from the unabbreviated form I.e. a structured query language
query.
--
Ticket URL: <https://code.djangoproject.com/ticket/21035#comment:2>
Django
--------------------------------------+------------------------------------
Reporter: EvilDMP | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: master
Keywords: afraid-to-commit | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Easy pickings: 1 | UI/UX: 0
Comment (by timo):
@mjtamlyn - Could you provide a reference? Otherwise, we discussed this at
some length in IRC and agreed that the rule is phonetic. Unofficial
research: http://english.stackexchange.com/questions/5265/an-sql-server-
database-schema-or-a-sql-server-database-schema
--
Ticket URL: <https://code.djangoproject.com/ticket/21035#comment:3>
Django
-------------------------------------+-------------------------------------
Reporter: EvilDMP | Owner:
Type: | EricBoersma
Cleanup/optimization | Status: assigned
Component: Documentation | Version: master
Severity: Normal | Resolution:
Keywords: afraid-to-commit | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Easy pickings: 1 | UI/UX: 0
Changes (by EricBoersma):
* owner: nobody => EricBoersma
* status: new => assigned
--
Ticket URL: <https://code.djangoproject.com/ticket/21035#comment:4>
Django
-------------------------------------+-------------------------------------
Reporter: EvilDMP | Owner:
Type: | EricBoersma
Component: Documentation | Version: master
Severity: Normal | Resolution: fixed
Keywords: afraid-to-commit | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Easy pickings: 1 | UI/UX: 0
Changes (by Tim Graham <timograham@…>):
* status: assigned => closed
* resolution: => fixed
Comment:
In [changeset:"4d13cc56de46ccfc89e9f1381ba4f194070bbdb7"]:
{{{
#!CommitTicketReference repository=""
revision="4d13cc56de46ccfc89e9f1381ba4f194070bbdb7"
Fixed #21035 -- Changed docs to treat the acronym SQL phonetically.
The documentation and comments now all use 'an' to
refer to the word SQL and not 'a'.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/21035#comment:5>
Django
-------------------------------------+-------------------------------------
Reporter: EvilDMP | Owner:
Type: | EricBoersma
Cleanup/optimization | Status: closed
Severity: Normal | Resolution: fixed
Keywords: afraid-to-commit | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Easy pickings: 1 | UI/UX: 0
Comment (by Tim Graham <timograham@…>):
In [changeset:"180b9955cc8816dba1534257f63c6ce389b10759"]:
{{{
#!CommitTicketReference repository=""
revision="180b9955cc8816dba1534257f63c6ce389b10759"
[1.6.x] Fixed #21035 -- Changed docs to treat the acronym SQL
phonetically.
The documentation and comments now all use 'an' to
refer to the word SQL and not 'a'.
Backport of 4d13cc56de from master
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/21035#comment:6>