[Django] #32956: Modernise spellings of Web, Email et al
Django
-----------------------------------------+------------------------
Reporter: David Smith | Owner: nobody
Type: Uncategorized | Status: new
Component: Uncategorized | Version: 3.2
Severity: Normal | Keywords:
Triage Stage: Unreviewed | Has patch: 0
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 0
UI/UX: 0 |
-----------------------------------------+------------------------
Historically it was 'The Web' but as language has evolved it is now the
'web' with a lower case w.
Popular style guides of the NYT, AP and the Guardian newspaper in the UK
all use the lower case version. This lower case preference is also true of
other tech words such as email, and we should audit for those as well as
part of this ticket.
https://web.archive.org/web/20150714234606/https://www.thewire.com/national/2013/10
/tweet-and-email-are-now-fit-print/70864/
https://twitter.com/APStylebook/status/716279539052191746?s=19
https://www.theguardian.com/guardian-observer-style-guide-w
--
Ticket URL: <https://code.djangoproject.com/ticket/32956>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
Django
Reporter: David Smith | Owner: David
Type: | Smith
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 3.2
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Changes (by Mariusz Felisiak):
* owner: nobody => David Smith
* status: new => assigned
* type: Uncategorized => Cleanup/optimization
* component: Uncategorized => Documentation
* stage: Unreviewed => Accepted
Comment:
Thanks, I assigned it to you :)
I'm pretty sure that we've discussed this in some PR but I cannot find it,
if you remember where it was please add a link.
--
Ticket URL: <https://code.djangoproject.com/ticket/32956#comment:1>
Django
Reporter: David Smith | Owner: David
Type: | Smith
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 3.2
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by David Smith):
Thanks Mariusz,
For the link on previous discussion it was a Twitter thread. I've
provided a couple of links, unfortunately
Tim Berners-Lee didn't respond š
https://twitter.com/carltongibson/status/1367106089892913155?s=19
https://twitter.com/carltongibson/status/1367197635174621190?s=19
--
Ticket URL: <https://code.djangoproject.com/ticket/32956#comment:2>
Django
Reporter: David Smith | Owner: David
Type: | Smith
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 3.2
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by Tim Graham):
Please update
[https://docs.djangoproject.com/en/dev/internals/contributing/writing-
documentation/#commonly-used-terms Commonly used terms] as appropriate.
--
Ticket URL: <https://code.djangoproject.com/ticket/32956#comment:3>
Django
Reporter: David Smith | Owner: David
Type: | Smith
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 3.2
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by Carlton Gibson):
I think we discussed in on https://github.com/django/django/pull/13981ā
which matches the tweet date.
We stuck with `Web` for not having a clearer answer, but in the subsequent
discussion Simon Willison made the (nice I think) suggestion that the AP
Styleguide should be treated as the Black for writing. Given the `en-us`
locale I think that's a good policy, so +1 (If only it were automated...
:)
--
Ticket URL: <https://code.djangoproject.com/ticket/32956#comment:4>
Django
Reporter: David Smith | Owner: David
Type: | Smith
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 3.2
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by David Smith):
What do you all think about the phrase 'Django Web Framework'. That sounds
like a name / title to me and should all be capitalised. There are places
in the docs with the project being called the Django Web Framework.
Having said that I thought the project is styled just 'Django' and so the
words web framework are describing what it is and should be lower cased?
Feels like there may have been a re-brand at some time? š¤
--
Ticket URL: <https://code.djangoproject.com/ticket/32956#comment:5>
Django
Reporter: David Smith | Owner: David
Type: | Smith
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 3.2
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by Jacob Walls):
Sure, if inconsistent, that could be cleaned up, also.
I think "Django web framework" would do it. If we're modernizing "web",
"web framework" is just as valid as a noun as "learning management
system." I don't think it needs to be capitalized and brought into the
"brand" ... [clears throat:] "Django Web Framework: The web framework for
perfectionists..." etc. No good.
--
Ticket URL: <https://code.djangoproject.com/ticket/32956#comment:6>
Django
Reporter: David Smith | Owner: David
Type: | Smith
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 3.2
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by David Smith):
> AP Styleguide should be treated as the Black for writing
I've purchased a copy of the stylebook and I've already spotted a few
words where the recomended approach is not followed. e.g. It is Afterward
not afterwards (the latter seems to be "British"), also it's Adviser not
Advisor.
I wonder if the scope of this ticket could be widened to capture adherence
to the AP Stylebook rather than than just a few words?
We should still assess each change on it's own merrits.
--
Ticket URL: <https://code.djangoproject.com/ticket/32956#comment:7>
Django
Reporter: David Smith | Owner: David
Type: | Smith
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 3.2
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by Carlton Gibson):
Hey David. Good work! :)
I think best to keep the scope narrow, otherwise it gets unwieldy ā it
becomes impossible to say when the ticket is addressed. (We can always add
`Refs` commits, or small ones under the typos don't need a ticket rule.)
But, yes, if we can make the style more consistent, presumably that's for
the win.
--
Ticket URL: <https://code.djangoproject.com/ticket/32956#comment:8>
Django
Reporter: David Smith | Owner: David
Type: | Smith
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 3.2
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by GitHub <noreply@ā¦>):
In [changeset:"1cba3207867fb168788ad6120770d0398b6b2807" 1cba320]:
{{{
#!CommitTicketReference repository=""
revision="1cba3207867fb168788ad6120770d0398b6b2807"
Refs #32956 -- Changed "afterwards" to "afterward" in docs and comments.
This also removes unnecessary comments with the previous spelling.
AP Stylebook has a short entry to advise the preferred spelling for
"en-us". "Afterwards" is preferred in British English.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/32956#comment:9>
Django
Reporter: David Smith | Owner: David
Type: | Smith
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 3.2
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by GitHub <noreply@ā¦>):
In [changeset:"acde91745656a852a15db7611c08cabf93bb735b" acde9174]:
{{{
#!CommitTicketReference repository=""
revision="acde91745656a852a15db7611c08cabf93bb735b"
Refs #32956 -- Lowercased "internet" and "email" where appropriate.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/32956#comment:10>
Django
Reporter: David Smith | Owner: David
Type: | Smith
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 3.2
Severity: Normal | Resolution:
| checkin
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Changes (by Mariusz Felisiak):
* has_patch: 0 => 1
* stage: Accepted => Ready for checkin
--
Ticket URL: <https://code.djangoproject.com/ticket/32956#comment:11>
Django
Reporter: David Smith | Owner: David
Type: | Smith
Component: Documentation | Version: 3.2
Severity: Normal | Resolution: fixed
Keywords: | Triage Stage: Ready for
| checkin
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Changes (by Mariusz Felisiak):
* status: assigned => closed
* resolution: => fixed
Comment:
In 1024b5e74a7166313ad4e4975a15e90dccd3ec5f:
Fixed 32956 -- Lowercased spelling of "web" and "web framework" where
appropriate.
--
Ticket URL: <https://code.djangoproject.com/ticket/32956#comment:12>
Django
Reporter: David Smith | Owner: David
Type: | Smith
Cleanup/optimization | Status: closed
Component: Documentation | Version: 3.2
Severity: Normal | Resolution: fixed
Keywords: | Triage Stage: Ready for
| checkin
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by GitHub <noreply@ā¦>):
In [changeset:"fbb1984046ae00bdf0b894a6b63294395da1cce8" fbb19840]:
{{{
#!CommitTicketReference repository=""
revision="fbb1984046ae00bdf0b894a6b63294395da1cce8"
Refs #32956 -- Updated words ending in -wards.
AP styleguide: Virtually none of the words ending with -wards end with
an s.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/32956#comment:13>
Django
Reporter: David Smith | Owner: David
Type: | Smith
Cleanup/optimization | Status: closed
Component: Documentation | Version: 3.2
Severity: Normal | Resolution: fixed
Keywords: | Triage Stage: Ready for
| checkin
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by GitHub <noreply@ā¦>):
In [changeset:"6802ac4415d6ebf9500df47dc22727a1d1b569d1" 6802ac44]:
{{{
#!CommitTicketReference repository=""
revision="6802ac4415d6ebf9500df47dc22727a1d1b569d1"
Refs #32956 -- Corrected usage of "insure" and "assure".
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/32956#comment:14>
Django
Reporter: David Smith | Owner: David
Type: | Smith
Cleanup/optimization | Status: closed
Component: Documentation | Version: 3.2
Severity: Normal | Resolution: fixed
Keywords: | Triage Stage: Ready for
| checkin
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by GitHub <noreply@ā¦>):
In [changeset:"f9b7704ab38d82d1de0c26deb542e497ebf14df6" f9b7704a]:
{{{
#!CommitTicketReference repository=""
revision="f9b7704ab38d82d1de0c26deb542e497ebf14df6"
Refs #32956 -- Corrected spelling of "gray".
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/32956#comment:15>
Django
Reporter: David Smith | Owner: David
Type: | Smith
Cleanup/optimization | Status: closed
Component: Documentation | Version: 3.2
Severity: Normal | Resolution: fixed
Keywords: | Triage Stage: Ready for
| checkin
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by Mariusz Felisiak <felisiak.mariusz@ā¦>):
In [changeset:"8208381ba6a3d1613bb746617062ccf1a6a28591" 8208381b]:
{{{
#!CommitTicketReference repository=""
revision="8208381ba6a3d1613bb746617062ccf1a6a28591"
Refs #32956 -- Corrected spelling of daylight saving time.
AP Stylebook: Saving not savings, no hyphen, and lowercase.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/32956#comment:16>
Django
Reporter: David Smith | Owner: David
Type: | Smith
Cleanup/optimization | Status: closed
Component: Documentation | Version: 3.2
Severity: Normal | Resolution: fixed
Keywords: | Triage Stage: Ready for
| checkin
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by Mariusz Felisiak <felisiak.mariusz@ā¦>):
In [changeset:"69b0736fad1d1f0197409ca025b7bcdf5666ae62" 69b0736]:
{{{
#!CommitTicketReference repository=""
revision="69b0736fad1d1f0197409ca025b7bcdf5666ae62"
Refs #32956 -- Changed docs to treat the acronym HTTP phonetically.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/32956#comment:17>
Django
Reporter: David Smith | Owner: David
Type: | Smith
Cleanup/optimization | Status: closed
Component: Documentation | Version: 3.2
Severity: Normal | Resolution: fixed
Keywords: | Triage Stage: Ready for
| checkin
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by Mariusz Felisiak <felisiak.mariusz@ā¦>):
In [changeset:"6aa917383faaa80e70c6a8a8bc0f52f088434a84" 6aa9173]:
{{{
#!CommitTicketReference repository=""
revision="6aa917383faaa80e70c6a8a8bc0f52f088434a84"
[4.0.x] Refs #32956 -- Changed docs to treat the acronym HTTP
phonetically.
Backport of 69b0736fad1d1f0197409ca025b7bcdf5666ae62 from main
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/32956#comment:18>
Django
Reporter: David Smith | Owner: David
Type: | Smith
Cleanup/optimization | Status: closed
Component: Documentation | Version: 3.2
Severity: Normal | Resolution: fixed
Keywords: | Triage Stage: Ready for
| checkin
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by Mariusz Felisiak <felisiak.mariusz@ā¦>):
In [changeset:"7ef0bc922c0a78667ed8cbf5f85845b627ccbdf8" 7ef0bc9]:
{{{
#!CommitTicketReference repository=""
revision="7ef0bc922c0a78667ed8cbf5f85845b627ccbdf8"
Refs #32956 -- Capitalized HTTP/HTTPS in comments, docs, and docstrings.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/32956#comment:19>
Django
Reporter: David Smith | Owner: David
Type: | Smith
Cleanup/optimization | Status: closed
Component: Documentation | Version: 3.2
Severity: Normal | Resolution: fixed
Keywords: | Triage Stage: Ready for
| checkin
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by Mariusz Felisiak <felisiak.mariusz@ā¦>):
In [changeset:"5d62beb61a7d5a6bb2755d2cdabc8e31f462391f" 5d62beb6]:
{{{
#!CommitTicketReference repository=""
revision="5d62beb61a7d5a6bb2755d2cdabc8e31f462391f"
[4.0.x] Refs #32956 -- Capitalized HTTP/HTTPS in comments, docs, and
docstrings.
Backport of 7ef0bc922c0a78667ed8cbf5f85845b627ccbdf8 from main
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/32956#comment:20>