#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 , 11 years ago
Summary: | Assume "Ess queue ell" rather than "sequel" for in Django code and docs → Assume "Ess queue ell" rather than "sequel" for SQL in Django code and docs |
---|---|
Triage Stage: | Unreviewed → Accepted |
comment:2 by , 11 years ago
comment:3 by , 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 , 11 years ago
Owner: | changed from | to
---|---|
Status: | new → assigned |
comment:5 by , 11 years ago
Resolution: | → fixed |
---|---|
Status: | assigned → closed |
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.