From 405813bfa6d62f99c73873914c96336934dbe0ad Mon Sep 17 00:00:00 2001 From: Murray Stokely Date: Mon, 19 Oct 2009 07:26:46 +0000 Subject: [PATCH] Add an internationalization policy for country/region lists in documentation, menus, etc.. Approved by: core@ --- en/internal/Makefile | 3 ++- en/internal/i18n.sgml | 43 +++++++++++++++++++++++++++++++++++++++ en/internal/policies.sgml | 3 ++- 3 files changed, 47 insertions(+), 2 deletions(-) create mode 100644 en/internal/i18n.sgml diff --git a/en/internal/Makefile b/en/internal/Makefile index f5af10a6b9..07e2e03331 100644 --- a/en/internal/Makefile +++ b/en/internal/Makefile @@ -1,4 +1,4 @@ -# $FreeBSD: www/en/internal/Makefile,v 1.46 2006/05/29 19:43:22 simon Exp $ +# $FreeBSD: www/en/internal/Makefile,v 1.47 2007/02/18 12:40:45 simon Exp $ .if exists(../Makefile.conf) .include "../Makefile.conf" @@ -22,6 +22,7 @@ DOCS+= core-vote.sgml DOCS+= doceng.sgml DOCS+= policies.sgml DOCS+= fortunes.sgml +DOCS+= i18n.sgml INDEXLINK= internal.html diff --git a/en/internal/i18n.sgml b/en/internal/i18n.sgml new file mode 100644 index 0000000000..5b833a2b1b --- /dev/null +++ b/en/internal/i18n.sgml @@ -0,0 +1,43 @@ + + + + +]> + + + &header; + +

Policy

+ +

When listing countries or other geographic areas in + documentation, menus, mirror/FTP lists, or other contexts, it is + important to introduce such lists as "Countries or Regions" so that + an implied sovereignty claim is neither made nor denied to those + regions which have their own top level domains.

+ +

The ISO 3361 country codes do not necessarily refer to + nation-states (e.g. Hong Kong) and should not be treated as such. + Likewise the "official" ISO 3361 short english names for those + countries and regions which have top level domains are in some cases + controversial, and not all of them are commonly used in the software + industry.

+ +

We follow the guidelines used by IBM, Microsoft, Google, and + other prominent software companies in their documentation in that + Taiwan should never be included with a distinction referring to the + Republic of China, People's Republic of China, or a national flag. + Interpretation of the word "Taiwan" is in the eye of the beholder, + and The FreeBSD Project does not endorse any particular position.

+ +

Reference:

+
    +
  1. IBM +Localization guidelines
    2. +
+ + &footer; + + + diff --git a/en/internal/policies.sgml b/en/internal/policies.sgml index 55b7e63e38..f875760e9f 100644 --- a/en/internal/policies.sgml +++ b/en/internal/policies.sgml @@ -1,6 +1,6 @@ - + ]> @@ -38,6 +38,7 @@ the Core's Voting Procedures, the Fortune File Policy, +Internationalization Policy, and the Problem Report Handling Guidelines.