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)
Change History (6)
comment:1 by , 16 years ago
comment:2 by , 16 years ago
Triage Stage: | Unreviewed → Accepted |
---|
We're perfectionists (with deadlines), so we should get it right.
comment:3 by , 16 years ago
Owner: | changed from | to
---|---|
Status: | new → assigned |
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:5 by , 15 years ago
Resolution: | → fixed |
---|---|
Status: | assigned → closed |
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...