Opened 11 years ago

Closed 11 years ago

Last modified 11 years ago

#21035 closed Cleanup/optimization (fixed)

Assume "Ess queue ell" rather than "sequel" for SQL in Django code and docs

Reported by: Daniele Procida Owned by: EricBoersma
Component: Documentation Version: dev
Severity: Normal Keywords: afraid-to-commit
Cc: Triage Stage: Accepted
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: yes UI/UX: no

Description

"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.

Change History (6)

comment:1 by Daniele Procida, 11 years ago

Summary: Assume "Ess queue ell" rather than "sequel" for in Django code and docsAssume "Ess queue ell" rather than "sequel" for SQL in Django code and docs
Triage Stage: UnreviewedAccepted

comment:2 by Marc Tamlyn, 11 years ago

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.

comment:3 by Tim Graham, 11 years ago

@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

comment:4 by EricBoersma, 11 years ago

Owner: changed from nobody to EricBoersma
Status: newassigned

comment:5 by Tim Graham <timograham@…>, 11 years ago

Resolution: fixed
Status: assignedclosed

In 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'.

comment:6 by Tim Graham <timograham@…>, 11 years ago

In 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

Note: See TracTickets for help on using tickets.
Back to Top