Opened 10 years ago

Closed 9 years ago

#7283 closed (fixed)

Documentation mixes up the terms "internationalization" and "localization"

Reported by: jdetaeye Owned by: Malcolm Tredinnick
Component: Documentation Version: master
Severity: Keywords: localization internationalization
Cc: Triage Stage: Accepted
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no


Both terms have a distinct meaning (see eg
Internationalization is the process of designing a software application so that it can be adapted to various languages and regions without engineering changes.
Localization is the process of adapting software for a specific region or language by adding locale-specific components and translating text.

The django documentation on "internationalization" doesn't make such a distinction and mixes both.

Attachments (1)

i18n.patch (3.2 KB) - added by jdetaeye 10 years ago.
Documentation update

Download all attachments as: .zip

Change History (6)

comment:1 Changed 10 years ago by jdetaeye

If the ticket is accepted, I am more than willing to submit a documentation patch.

Not sure how that'ld work out with the documentation refactoring, which I understood is ongoing...

comment:2 Changed 10 years ago by Simon Greenhill

Triage Stage: UnreviewedAccepted

We're perfectionists (with deadlines), so we should get it right.

Changed 10 years ago by jdetaeye

Attachment: i18n.patch added

Documentation update

comment:3 Changed 10 years ago by Malcolm Tredinnick

Owner: changed from nobody to Malcolm Tredinnick
Status: newassigned

Although there is some confusion in that document, this patch doesn't make it all that much better unfortunately. For example, the "three step" section is actually internationalisation in the first step and localisation in the next two, not all internationalising or all localising (marking up strings for translation is internationalisation; it requires no translation skills or locale knowledge). Similarly, the i18n.txt does cover internationalisation, since it talks about things like using the ugettext family of functions (again, not part of the localisation step).

However, your greater point is well taken. There is indeed some confusion in there and separating out the internationalisation process (the developer side) from the translator side from the third, user side of things is one of the reasons I'm about to pull that document apart. So I'll take close this ticket when that's merged.

comment:4 Changed 9 years ago by Ramiro Morales

See also #10260

comment:5 Changed 9 years ago by Ramiro Morales

Resolution: fixed
Status: assignedclosed

Fixed in r12440 (trunk pre-1.2) and r12449 (1.1.X branch).

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