Developer support

Advice

If you need internationalization advice you can contact us in a couple of ways.

If you want advice on a discussion taking place in a GitHub issue thread, the best way to alert us is to add the i18n-tracker label to the issue. We'll be notified. If you have a specific question, add it in a comment. This approach is particularly useful since it keeps discussion threads linked to existing discussions and to appropriate repos.

Alternatively, technical questions can be sent to www-international@w3.org. This is the mailing list of the Internationalization Interest Group.

Resources

We are trying to write down as much as we can, so that you don't always need to contact us for information.

The following may be useful:

Spec development techniques page

This page provides do's and dont's for spec developers, with links to explanations and examples, and links to useful documents. The information is arranged so that you can quickly drill down to the information that interests you, and is grouped in a task-oriented way.

The information in the expandable list is distilled from the document Internationalization Best Practices for Spec Developers. You can obtain the same information by using the expandable list or the document.

I18n Notes and WDs

The Internationalization Activity also published additional documents that provide in-depth coverage of a particular area. The link just above takes you to a complete list of technical reports produced by the Activity, but the following list highlights some particularly useful ones.

Strings on the Web: Language and Direction Metadata. Describe the best practices for identifying language and base direction for strings that will be used on the Web.

Character Model for the World Wide Web: Fundamentals. Architectural specification providing specification and software developers, and content developers with a common reference for interoperable text manipulation on the World Wide Web. Topics addressed include use of the terms 'character', 'encoding' and 'string', a reference processing model, choice and identification of character encodings, character escaping, and string indexing..

Character Model for the World Wide Web: String Matching. Provides authors of specifications, software developers, and content developers a common reference on string identity matching on the World Wide Web. Topics include string identity matching and normalization.

Language Tags and Locale Identifiers for the World Wide Web. Best practices for labelling natural language content and locale preferences in document formats, specifications, and implementations on the Web..

Best Practices for XML Internationalization. A set of guidelines for developing XML documents and schemas that are internationalized properly. Following the best practices describes here allow both the developer of XML applications, as well as the author of XML content to create material in different languages.

Internationalization Tag Set (ITS). Defines data categories and their implementation as a set of elements and attributes called the Internationalization Tag Set (ITS). ITS is designed to be used with schemas to support the internationalization and localization of schemas and documents. An implementation is provided for three schema languages: XML DTD, XML Schema and RELAX NG.

Working with Time Zones. Guidelines for working with time and time zones in applications and document formats. Use cases help developers choose an approach to date and time values that works well with geographically distributed applications. Also provides a vocabulary for talking about time in software, a source of confusion for many developers and content authors on the Web.

Language enablement

Developers who want to better understand language or writing system features, and what must be taken into account to develop internationalized solutions, can find relevant information using the Language Enablement Index.

Other useful resources include the Layout issue tracker, which lists outstanding questions and discussions related to language enablement. Also, the Type Samples library provides pictures of typographic features in the wild.

For more details about the language enablement work of the Activity, see this separate page.

Tests

The Internationalization Activity has tests for internationalization features that not look at whether specs are supported in user agents, but also explore how browsers and other user agents handle regional requirements for language support.

There are two main sets of tests. The i18n test suite conforms to the Web Platform Tests approach, and most of those tests are ported to the WPT repository. There is also a set of test rigs that can be used in an interactive way to rapidly set up and share tests that explore user-agent support for language-related and spec features; these are particularly useful to support gap-analysis during the language enablement work.