Opened 22 months ago

Closed 22 months ago

Last modified 22 months ago

#21035 closed Cleanup/optimization (fixed)

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

Reported by: EvilDMP Owned by: EricBoersma
Component: Documentation Version: master
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 Changed 22 months ago by EvilDMP

  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset
  • Summary changed from Assume "Ess queue ell" rather than "sequel" for in Django code and docs to Assume "Ess queue ell" rather than "sequel" for SQL in Django code and docs
  • Triage Stage changed from Unreviewed to Accepted

comment:2 Changed 22 months ago 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.

comment:3 Changed 22 months ago 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

comment:4 Changed 22 months ago by EricBoersma

  • Owner changed from nobody to EricBoersma
  • Status changed from new to assigned

comment:5 Changed 22 months ago by Tim Graham <timograham@…>

  • Resolution set to fixed
  • Status changed from assigned to closed

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 Changed 22 months ago by Tim Graham <timograham@…>

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