W3cubDocs

/Angular

Angular documentation localization guidelines

One way to contribute to Angular's documentation is to localize it into another language. This topic describes what you need to know to localize Angular and have it listed on our Localized documentation page.

Before you begin

Before you start localizing the Angular documentation, first check to see if a localized version already exists. See Localized documentation for a current list of localized versions of Angular documentation.

Getting started

To have a localized version of Angular documentation listed on angular.io, you must either:

Nomination, in this instance, means that the GDE knows who you are and can vouch for your capabilities. An Angular GDE can nominate someone by contacting the Angular team, providing your name, contact information, and the language to which you are localizing.

What to localize

To localize Angular documentation, you must include, at a minimum, the following topics:

Because these topics reflect the minimum documentation set for localization, the Angular documentation team takes special precautions when making any changes to these topics. Specifically:

  • The Angular team carefully assesses any incoming pull requests or issues to determine their impact on localized content.
  • If the Angular team incorporates changes into these topics, the Angular team will communicate those changes to members of the localization community. See the section, Communications, for more information.

Hosting

Individuals and teams that localize Angular documentation assume responsibility for hosting their localized site. The Angular team does not host localized content. The Angular team is also not responsible for providing domain names.

Awareness

As part of the localization effort, the Angular documentation team adds localized documentation to the Localized documentation page. This topic lists:

  • The language of the localized documentation
  • The URL for the localized documentation

The Angular team can remove a link on this page for any reason, including but not limited to:

  • Inability to contact the individual or team
  • Issues or complaints about the documentation that go unaddressed

Communications

The Angular documentation team uses a Slack channel to communicate with members of the community focused on localization efforts. After receiving a nomination to localize content, an individual or team can contact the Angular team to get access to this Slack channel.

The Angular documentation team may also conduct meetings to discuss localization efforts. For example:

  • To discuss additional topics that should be part of the minimum documentation set
  • To discuss issues with content language that is difficult to translate/localize

© 2010–2021 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://angular.io/guide/localizing-angular