Opened 7 years ago

Last modified 16 months ago

#27778 assigned Cleanup/optimization

Update unicode documentation for Python 3

Reported by: Aymeric Augustin Owned by: Basant Babu Bhandari
Component: Documentation Version: dev
Severity: Normal Keywords:
Cc: Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: yes
Easy pickings: no UI/UX: no

Description (last modified by Aymeric Augustin)

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

Change History (13)

comment:1 by Aymeric Augustin, 7 years ago

Description: modified (diff)

comment:2 by Claude Paroz, 7 years ago

Triage Stage: UnreviewedAccepted

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

comment:3 by Tim Graham <timograham@…>, 7 years ago

In d1bab24:

Refs #23919, #27778 -- Removed obsolete mentions of unicode.

comment:4 by Tim Graham, 7 years ago

Summary: Update unicode documentationUpdate unicode documentation for Python 3

comment:5 by ChillarAnand, 7 years ago

Owner: changed from nobody to ChillarAnand
Status: newassigned

comment:6 by Tim Graham, 7 years ago

Has patch: set
Patch needs improvement: set

A PR starts this but hasn't done much rewriting yet.

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

In f5d9ee1:

Refs #27778 -- Removed "The database API" section from "Unicode data" docs.

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

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

In d1b25a64:

[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

comment:9 by GitHub <noreply@…>, 4 years ago

In 505b7b6:

Refs #27778 -- Removed reference to ASCII usernames in django.contrib.auth.models.User docs.

comment:10 by Mariusz Felisiak <felisiak.mariusz@…>, 4 years ago

In fc0e087:

[3.0.x] Refs #27778 -- Removed reference to ASCII usernames in django.contrib.auth.models.User docs.

Backport of 505b7b616320b8d5bbc83d0dbbb3aec3a58ba0c9 from master

comment:11 by Mariusz Felisiak, 3 years ago

Owner: ChillarAnand removed
Status: assignednew

comment:12 by Basant Babu Bhandari, 16 months ago

Owner: set to Basant Babu Bhandari
Status: newassigned

working on it

comment:13 by Basant Babu Bhandari, 16 months ago

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

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