Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "COSMOS Design 208593"
Jim.gyng.com (Talk | contribs) (→'''GUI Considerations''') |
Jim.gyng.com (Talk | contribs) (→'''Task Breakdown''') |
||
| (10 intermediate revisions by 2 users not shown) | |||
| Line 91: | Line 91: | ||
</p> | </p> | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | == ''' | + | == ''' Codebase Considerations ''' == |
The COSMOS code must consider the following guidelines to support i18n: | The COSMOS code must consider the following guidelines to support i18n: | ||
| Line 128: | Line 120: | ||
# Dynamic user elements should not be used when special and complicated layout configurations are needed | # Dynamic user elements should not be used when special and complicated layout configurations are needed | ||
# Allocating extra space as translated text may be much longer than the English text | # Allocating extra space as translated text may be much longer than the English text | ||
| + | # Do not split multi-byte characters | ||
| − | == ''' | + | == '''Message Handling Considerations''' == |
| − | + | The COSMOS messages must consider the following guidelines to support i18n: | |
| − | + | # Prefix each message with unique message-ids | |
| − | + | # Label 3rd party messages when shown from COSMOS | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | == ''' | + | == '''i18n Checklist''' == |
| − | + | Here is a check list to determine whether COSMOS is i18n-ready or not: | |
| + | # Menus, dialogs and web layouts can tolerate text expansion | ||
| + | # Development language strings are reviewed for meaning and spelling to reduce user confusion and lessen translation errors | ||
| + | # Third-party software used in the product is examined for i18n support | ||
| + | # Consistent terminology is used in messages | ||
| + | # COSMOS runs properly in its base language in all target locales | ||
| + | # Strings are not assembled by concatenation of fragments | ||
| + | # Source code does not contain hard-coded character constants, numeric constants, screen positions, filenames or pathnames that assume a particular language | ||
| + | # String buffers are large enough to handle translated words and phrases | ||
| + | # East Asian editions support line-breaking rules | ||
| + | # All international editions of the program are compiled from one set of source files | ||
| + | # Localizable items are stored in resource files, message tables or message catalogues | ||
| + | # All language editions share a common file format | ||
| + | # Program handles non-homogeneous network environments where machines are operating with different encodings | ||
| + | # No assumptions are made that one character storage element represents one linguistic character | ||
| + | # Code does not use embedded font names or make assumptions about particular fonts being available | ||
| + | # Program displays and prints text using appropriate fonts | ||
| + | # Sorting and case conversion are culturally correct | ||
| + | # Application works correctly on localized editions of the target operating system(s) | ||
| + | # Specific for web internationalization: | ||
| + | ## Check middle-tier components for internationalization compliance | ||
| + | ## Ensure that information about encoding and locale of data is passed correctly between presentation and backend tiers | ||
| − | + | == '''Task Breakdown''' == | |
| + | The following section includes the tasks required to complete this enhancement. | ||
| − | # | + | # Get this design approved |
| − | # | + | # Determine the follow in ERs needed for i9 |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
== '''Open Issues/Questions '''== | == '''Open Issues/Questions '''== | ||
| Line 176: | Line 167: | ||
* Should this ER address the Language Groups issue? Or should this be deemed out of scope since COSMOS 1.0 will not address localization? | * Should this ER address the Language Groups issue? Or should this be deemed out of scope since COSMOS 1.0 will not address localization? | ||
* Where does XLIFF fit into the i18n considerations? http://docs.oasis-open.org/xliff/v1.2/cs02/xliff-core.html | * Where does XLIFF fit into the i18n considerations? http://docs.oasis-open.org/xliff/v1.2/cs02/xliff-core.html | ||
| + | * How about i18n issues OUTSIDE the code, e.g. what if COSMOS has to deal with two MDRs, each from a different continent? | ||
| + | |||
| + | --[[User:Popescu.ca.ibm.com|Popescu.ca.ibm.com]] 13:23, 4 January 2008 (EST)XLIFF is one option for localization support in xml documents. | ||
---- | ---- | ||
[[Category:COSMOS_Bugzilla_Designs]] | [[Category:COSMOS_Bugzilla_Designs]] | ||
Latest revision as of 14:12, 15 January 2008
Contents
Internationalization Support - programming model
Change History
| Name: | Date: | Revised Sections: |
|---|---|---|
| Jimmy Mohsin | 01/3/2008 |
|
Workload Estimation
| Process | Sizing | Names of people doing the work |
|---|---|---|
| Design | 1 | Jimmy Mohsin |
| Code (not part of this ER) | 4 | Dev Team |
| Test (not part of this ER) | 4 | QA Team |
| Documentation (not part of this ER) | 1 | |
| Build and infrastructure (not part of this ER) | 1 | |
| Code review, etc. (not part of this ER) | 1 | |
| TOTAL | 12 |
Terminologies/Acronyms
The terminologies/acronyms below are commonly used throughout this document. The list below defines each term regarding how it is used in this document:
| Term | Definition |
|---|---|
| Internationalization | The process of generalizing the design of a product so that it can handle multiple languages and cultural conventions without the need for making code changes for each language. COSMOS 1.0 will be internationalized for its eventual adoption and deployment |
| Localization | The process of taking an internationalized product and making it linguistically and culturally appropriate to the target locale (country/region and language) where it will be used. COSMOS 1.0 will not be localized for any non-US English languages, this is something that the adopers will need to do. |
| Translatable Elements | Everything intended to be locale and language dependent. These items may need to be modified for different locales, e.g. date formats, time formats, word lists for content controls, and so on. |
| Non-user elements | Everything not intended for end-users to see and understand. This fits into two categories, proper names and internal elements. Examples of internal elements are command line commands and options, debug strings, registry keys, program file names, comments, and so on. Examples of proper names are product name, company name, and so on. |
| User Elements | Everything intended for end-users to see and understand, e.g. menus and menu items, dialog boxes, windows, program groups, error messages, installation scripts, icons, buttons, "Display Name" and "Description" fields for services we create on Windows, and so on. |
Purpose
This enhancement is associated with bugzilla 208593.
The data visualization component does not follow a consisten design pattern to support internationalization. There are serveral components within the visualization project that require internationalization support:
- Dojo widgets
- Servlet data feeds
- XML configuration files
- ANY OTHER COMPONENTS ???
Codebase Considerations
The COSMOS code must consider the following guidelines to support i18n:
- Externalize all translatable elements(i.e. no hardcoding)
- Put translatable elements in language modules separated from executables
- Generalize design to support any language
- Dynamically select and load language module at run time
- Separate build process for language modules from executable
- Gracefully handle missing language resources
- Handle regional settings
- Date Format and Time Formats
- Number Formats
- Currency
- Paper Size
- Sort Order
- Clearly identify which strings should or should not be translated
- Avoid string concatenation
- Not embed text in icons and bitmaps
GUI Considerations
The COSMOS GUI must consider the following guidelines to support i18n:
- Dynamic user elements should be used when displaying simple layouts and text messages
- Dynamic user elements should not be used when special and complicated layout configurations are needed
- Allocating extra space as translated text may be much longer than the English text
- Do not split multi-byte characters
Message Handling Considerations
The COSMOS messages must consider the following guidelines to support i18n:
- Prefix each message with unique message-ids
- Label 3rd party messages when shown from COSMOS
i18n Checklist
Here is a check list to determine whether COSMOS is i18n-ready or not:
- Menus, dialogs and web layouts can tolerate text expansion
- Development language strings are reviewed for meaning and spelling to reduce user confusion and lessen translation errors
- Third-party software used in the product is examined for i18n support
- Consistent terminology is used in messages
- COSMOS runs properly in its base language in all target locales
- Strings are not assembled by concatenation of fragments
- Source code does not contain hard-coded character constants, numeric constants, screen positions, filenames or pathnames that assume a particular language
- String buffers are large enough to handle translated words and phrases
- East Asian editions support line-breaking rules
- All international editions of the program are compiled from one set of source files
- Localizable items are stored in resource files, message tables or message catalogues
- All language editions share a common file format
- Program handles non-homogeneous network environments where machines are operating with different encodings
- No assumptions are made that one character storage element represents one linguistic character
- Code does not use embedded font names or make assumptions about particular fonts being available
- Program displays and prints text using appropriate fonts
- Sorting and case conversion are culturally correct
- Application works correctly on localized editions of the target operating system(s)
- Specific for web internationalization:
- Check middle-tier components for internationalization compliance
- Ensure that information about encoding and locale of data is passed correctly between presentation and backend tiers
Task Breakdown
The following section includes the tasks required to complete this enhancement.
- Get this design approved
- Determine the follow in ERs needed for i9
Open Issues/Questions
All reviewer feedback should go in the Talk page for 208593.
- Should this ER address the Language Groups issue? Or should this be deemed out of scope since COSMOS 1.0 will not address localization?
- Where does XLIFF fit into the i18n considerations? http://docs.oasis-open.org/xliff/v1.2/cs02/xliff-core.html
- How about i18n issues OUTSIDE the code, e.g. what if COSMOS has to deal with two MDRs, each from a different continent?
--Popescu.ca.ibm.com 13:23, 4 January 2008 (EST)XLIFF is one option for localization support in xml documents.