Opened 16 years ago

Closed 15 years ago

#7283 closed (fixed)

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

Reported by: jdetaeye Owned by: Malcolm Tredinnick
Component: Documentation Version: dev
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

Description

Both terms have a distinct meaning (see eg http://en.wikipedia.org/wiki/Internationalization_and_localization):
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 16 years ago.
Documentation update

Download all attachments as: .zip

Change History (6)

comment:1 by jdetaeye, 16 years ago

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 by Simon Greenhill, 16 years ago

Triage Stage: UnreviewedAccepted

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

by jdetaeye, 16 years ago

Attachment: i18n.patch added

Documentation update

comment:3 by Malcolm Tredinnick, 16 years ago

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 by Ramiro Morales, 16 years ago

See also #10260

comment:5 by Ramiro Morales, 15 years ago

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