Opened 6 years ago

Last modified 2 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 Changed 6 years ago by Aymeric Augustin

Description: modified (diff)

comment:2 Changed 6 years ago by Claude Paroz

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

In d1bab24:

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

comment:4 Changed 6 years ago by Tim Graham

Summary: Update unicode documentationUpdate unicode documentation for Python 3

comment:5 Changed 6 years ago by ChillarAnand

Owner: changed from nobody to ChillarAnand
Status: newassigned

comment:6 Changed 6 years ago by Tim Graham

Has patch: set
Patch needs improvement: set

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

comment:7 Changed 5 years ago by Tim Graham <timograham@…>

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

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 Changed 3 years ago by GitHub <noreply@…>

In 505b7b6:

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

comment:10 Changed 3 years ago by Mariusz Felisiak <felisiak.mariusz@…>

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 Changed 19 months ago by Mariusz Felisiak

Owner: ChillarAnand deleted
Status: assignednew

comment:12 Changed 2 months ago by Basant Babu Bhandari

Owner: set to Basant Babu Bhandari
Status: newassigned

working on it

comment:13 Changed 2 months ago by Basant Babu Bhandari

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

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