[Django] #27778: Update unicode documentation

10 views
Skip to first unread message

Django

unread,
Jan 26, 2017, 4:16:18 AM1/26/17
to django-...@googlegroups.com
#27778: Update unicode documentation
------------------------------------------------+------------------------
Reporter: Aymeric Augustin | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: master
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 |
------------------------------------------------+------------------------
The "Unicode data" page doesn't make sense for people who started on
Python 3 and who have always had the luxury of a `str` type that works.

Also it assumes that Python's default charset is ASCII, while it is UTF-8
now.

This page should be renamed to "Encoded data" and, instead of explaining
how unicode strings are different from (Python 2) regular strings, it
should explained how encoded strings are different from (Python 3) regular
strings and how external systems deal with them.

--
Ticket URL: <https://code.djangoproject.com/ticket/27778>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

Django

unread,
Jan 26, 2017, 4:17:18 AM1/26/17
to django-...@googlegroups.com
#27778: Update unicode documentation
-------------------------------------+-------------------------------------

Reporter: Aymeric Augustin | Owner: nobody
Type: | Status: new
Cleanup/optimization |
Component: Documentation | Version: master
Severity: Normal | Resolution:

Keywords: | Triage Stage:
| Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Description changed by Aymeric Augustin:

Old description:

> The "Unicode data" page doesn't make sense for people who started on
> Python 3 and who have always had the luxury of a `str` type that works.
>
> Also it assumes that Python's default charset is ASCII, while it is UTF-8
> now.
>
> This page should be renamed to "Encoded data" and, instead of explaining
> how unicode strings are different from (Python 2) regular strings, it
> should explained how encoded strings are different from (Python 3)
> regular strings and how external systems deal with them.

New description:

The "Unicode data" page doesn't make sense for people who started on
Python 3 and who have always had the luxury of a `str` type that works.

Also it assumes that Python's default charset is ASCII, while it is UTF-8
now.

This page should be renamed to "Encoded data" and, instead of explaining
how unicode strings are different from (Python 2) regular strings, it
should explained how encoded strings are different from (Python 3) regular
strings and how external systems deal with them.

There's also a handful of references to "Unicode strings" in other
documentation pages that should be changed to just "strings".

--

--
Ticket URL: <https://code.djangoproject.com/ticket/27778#comment:1>

Django

unread,
Jan 26, 2017, 7:42:57 AM1/26/17
to django-...@googlegroups.com
#27778: Update unicode documentation
--------------------------------------+------------------------------------

Reporter: Aymeric Augustin | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: master
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 Claude Paroz):

* stage: Unreviewed => Accepted


Comment:

This [https://github.com/django/django/pull/7918 PR] is dealing with the
unicode term replacement with "string". But as I commented on the PR, the
"Unicode data" page does indeed need to be rewritten.

--
Ticket URL: <https://code.djangoproject.com/ticket/27778#comment:2>

Django

unread,
Jan 26, 2017, 8:43:12 AM1/26/17
to django-...@googlegroups.com
#27778: Update unicode documentation
--------------------------------------+------------------------------------
Reporter: Aymeric Augustin | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: master
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
--------------------------------------+------------------------------------

Comment (by Tim Graham <timograham@…>):

In [changeset:"d1bab24e0144d14513a1411503c95ececb425188" d1bab24]:
{{{
#!CommitTicketReference repository=""
revision="d1bab24e0144d14513a1411503c95ececb425188"
Refs #23919, #27778 -- Removed obsolete mentions of unicode.
}}}

--
Ticket URL: <https://code.djangoproject.com/ticket/27778#comment:3>

Django

unread,
Jan 26, 2017, 10:00:10 AM1/26/17
to django-...@googlegroups.com
#27778: Update unicode documentation for Python 3
--------------------------------------+------------------------------------

Reporter: Aymeric Augustin | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: master
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
--------------------------------------+------------------------------------

--
Ticket URL: <https://code.djangoproject.com/ticket/27778#comment:4>

Django

unread,
Jan 27, 2017, 12:32:38 AM1/27/17
to django-...@googlegroups.com
#27778: Update unicode documentation for Python 3
-------------------------------------+-------------------------------------
Reporter: Aymeric Augustin | Owner:
Type: | ChillarAnand
Cleanup/optimization | Status: assigned
Component: Documentation | Version: master

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 ChillarAnand):

* status: new => assigned
* owner: nobody => ChillarAnand


--
Ticket URL: <https://code.djangoproject.com/ticket/27778#comment:5>

Django

unread,
Feb 4, 2017, 11:46:54 AM2/4/17
to django-...@googlegroups.com
#27778: Update unicode documentation for Python 3
-------------------------------------+-------------------------------------
Reporter: Aymeric Augustin | Owner:
Type: | ChillarAnand
Cleanup/optimization | Status: assigned
Component: Documentation | Version: master

Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1

Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by Tim Graham):

* needs_better_patch: 0 => 1
* has_patch: 0 => 1


Comment:

A [https://github.com/django/django/pull/7992 PR] starts this but hasn't
done much rewriting yet.

--
Ticket URL: <https://code.djangoproject.com/ticket/27778#comment:6>

Django

unread,
Oct 4, 2018, 9:10:43 AM10/4/18
to django-...@googlegroups.com
#27778: Update unicode documentation for Python 3
-------------------------------------+-------------------------------------
Reporter: Aymeric Augustin | Owner:
Type: | ChillarAnand
Cleanup/optimization | Status: assigned
Component: Documentation | Version: master

Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1

Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Comment (by Tim Graham <timograham@…>):

In [changeset:"f5d9ee11a2c76ba1cf7e3424d15286da121a004b" f5d9ee1]:
{{{
#!CommitTicketReference repository=""
revision="f5d9ee11a2c76ba1cf7e3424d15286da121a004b"
Refs #27778 -- Removed "The database API" section from "Unicode data"
docs.

Support for passing bytestrings to the database API was removed in
301de774c21d055e9e5a7073e5bffdb52bc71079.
}}}

--
Ticket URL: <https://code.djangoproject.com/ticket/27778#comment:7>

Django

unread,
Oct 4, 2018, 9:41:18 AM10/4/18
to django-...@googlegroups.com
#27778: Update unicode documentation for Python 3
-------------------------------------+-------------------------------------
Reporter: Aymeric Augustin | Owner:
Type: | ChillarAnand
Cleanup/optimization | Status: assigned
Component: Documentation | Version: master

Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1

Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Comment (by Tim Graham <timograham@…>):

In [changeset:"d1b25a64c21bd3649122dc991badf635e00dd2ae" d1b25a64]:
{{{
#!CommitTicketReference repository=""
revision="d1b25a64c21bd3649122dc991badf635e00dd2ae"
[2.1.x] Refs #27778 -- Removed "The database API" section from "Unicode
data" docs.

Support for passing bytestrings to the database API was removed in
301de774c21d055e9e5a7073e5bffdb52bc71079.

Backport of f5d9ee11a2c76ba1cf7e3424d15286da121a004b from master
}}}

--
Ticket URL: <https://code.djangoproject.com/ticket/27778#comment:8>

Django

unread,
May 1, 2020, 12:11:56 AM5/1/20
to django-...@googlegroups.com
#27778: Update unicode documentation for Python 3
-------------------------------------+-------------------------------------
Reporter: Aymeric Augustin | Owner:
Type: | ChillarAnand
Cleanup/optimization | Status: assigned
Component: Documentation | Version: master

Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1

Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Comment (by GitHub <noreply@…>):

In [changeset:"505b7b616320b8d5bbc83d0dbbb3aec3a58ba0c9" 505b7b6]:
{{{
#!CommitTicketReference repository=""
revision="505b7b616320b8d5bbc83d0dbbb3aec3a58ba0c9"
Refs #27778 -- Removed reference to ASCII usernames in
django.contrib.auth.models.User docs.
}}}

--
Ticket URL: <https://code.djangoproject.com/ticket/27778#comment:9>

Django

unread,
May 1, 2020, 12:12:33 AM5/1/20
to django-...@googlegroups.com
#27778: Update unicode documentation for Python 3
-------------------------------------+-------------------------------------
Reporter: Aymeric Augustin | Owner:
Type: | ChillarAnand
Cleanup/optimization | Status: assigned
Component: Documentation | Version: master

Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1

Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Comment (by Mariusz Felisiak <felisiak.mariusz@…>):

In [changeset:"fc0e0876da8b18ac70fc0e90e9fcc4d06682b8cb" fc0e087]:
{{{
#!CommitTicketReference repository=""
revision="fc0e0876da8b18ac70fc0e90e9fcc4d06682b8cb"
[3.0.x] Refs #27778 -- Removed reference to ASCII usernames in
django.contrib.auth.models.User docs.

Backport of 505b7b616320b8d5bbc83d0dbbb3aec3a58ba0c9 from master
}}}

--
Ticket URL: <https://code.djangoproject.com/ticket/27778#comment:10>

Django

unread,
Nov 16, 2021, 2:57:32 PM11/16/21
to django-...@googlegroups.com
#27778: Update unicode documentation for Python 3
--------------------------------------+------------------------------------
Reporter: Aymeric Augustin | Owner: (none)
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: dev

Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1

Easy pickings: 0 | UI/UX: 0
--------------------------------------+------------------------------------
Changes (by Mariusz Felisiak):

* owner: ChillarAnand => (none)
* status: assigned => new


--
Ticket URL: <https://code.djangoproject.com/ticket/27778#comment:11>

Django

unread,
Mar 31, 2023, 12:46:06 PM3/31/23
to django-...@googlegroups.com
#27778: Update unicode documentation for Python 3
-------------------------------------+-------------------------------------
Reporter: Aymeric Augustin | Owner: Basant
Type: | Babu Bhandari
Cleanup/optimization | Status: assigned

Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1

Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by Basant Babu Bhandari):

* owner: (none) => Basant Babu Bhandari


* status: new => assigned


Comment:

working on it

--
Ticket URL: <https://code.djangoproject.com/ticket/27778#comment:12>

Django

unread,
Mar 31, 2023, 12:51:41 PM3/31/23
to django-...@googlegroups.com
#27778: Update unicode documentation for Python 3
-------------------------------------+-------------------------------------
Reporter: Aymeric Augustin | Owner: Basant
Type: | Babu Bhandari
Cleanup/optimization | Status: assigned
Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1

Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Comment (by Basant Babu Bhandari):

I want to work on it can some body help me out

--
Ticket URL: <https://code.djangoproject.com/ticket/27778#comment:13>

Reply all
Reply to author
Forward
0 new messages