Update i18n.md
diff --git a/docs/userguide/i18n.md b/docs/userguide/i18n.md
index 538f13d..eb234a7 100644
--- a/docs/userguide/i18n.md
+++ b/docs/userguide/i18n.md
@@ -85,7 +85,7 @@
1. Separate the program's executable code from its UI elements.
-2. Avoid making cultural assumptions.
+1. Avoid making cultural assumptions.
Keep static information (such as pictures, window layouts) separate from the
program code. Also ensure that the text which the program generates on the fly
@@ -117,7 +117,11 @@
contains grammatical suffixes that English has lost in the last 800 years. The
following table shows how word lengths can differ among languages.
-EnglishGermanCyrillic-Serbiancutausschneidenисециcopykopierenкопирајpasteeinfügenзалепи
+| English | German | Cyrillic-Serbian |
+|---------|--------------|------------------|
+| cut | ausschneiden | исеци |
+| copy | kopieren | копирај |
+| paste | einfügen | залепи |
The description of the UI, especially user-visible pieces of text, must be kept
together and not embedded in the program's executable code. ICU provides the
@@ -145,9 +149,9 @@
Numbers and dates are represented in different languages. Do not implement
routines for converting numbers into strings, and do not call low-level system
-interfaces like sprintf() that do not produce language-sensitive results.
-Instead, see how ICU's [NumberFormat](formatparse/numbers/index.md) and
-[DateFormat](formatparse/datetime/index.md) services can be used more
+interfaces like `sprintf()` that do not produce language-sensitive results.
+Instead, see how ICU's [`NumberFormat`](formatparse/numbers/index.md) and
+[`DateFormat`](formatparse/datetime/index.md) services can be used more
effectively.
#### Messages
@@ -156,13 +160,13 @@
used together to create a complete sentence (for example, when error messages
are generated) . The elements might go together in a different order if the
message is translated into a new language. ICU provides
-[MessageFormat](formatparse/messages/index.md) (§) and
-[ChoiceFormat](formatparse/messages/index.md) (§) to help with these
+[`MessageFormat`](formatparse/messages/index.md) and
+[`ChoiceFormat`](formatparse/messages/index.md) to help with these
occurrences.
-*There also might be situations where parts of the sentence change when other
+:point_right: **Note**:There also might be situations where parts of the sentence change when other
parts of the sentence also change (selecting between singular and plural nouns
-that go after a number is the most common example). *
+that go after a number is the most common example).
#### Measuring Units
@@ -172,7 +176,7 @@
Canadian dollar values. US dollars can be displayed as USD while Canadian
dollars can be displayed as CAD, depending on the locale. In this case, the
displayed numerical quantity might change, and the number itself might also
-change. [NumberFormat](formatparse/numbers/index.md) provides some support for
+change. [`NumberFormat`](formatparse/numbers/index.md) provides some support for
this.
#### Alphabetical Order of Characters
@@ -182,13 +186,13 @@
same as the numerical order of the character's code-point values. In practice,
'a' is distinct from 'A' and 'b' is distinct from 'B'. Each has a different code
point . This means that you can not use a bit-wise lexical comparison (such as
-what strcmp() provides), to sort user-visible lists.
+what `strcmp()` provides), to sort user-visible lists.
Not all languages interpret the same characters as equivalent. If a character's
case is changed it is not always a one-to-one mapping. Accent differences, the
presence or absence of certain characters, and even spelling differences might
be insignificant when determining whether two strings are equal. The[
-Collator](collation/index.md) services provide significant help in this area.
+`Collator`](collation/index.md) services provide significant help in this area.
#### Characters
@@ -196,16 +200,16 @@
the backing store. All languages might not have the same definition of a word,
and might not find that any group of characters separated by a white space is an
acceptable approximation for the definition of a word. ICU provides the
-[BreakIterator](boundaryanalysis/index.md) services to help locate boundaries or
+[`BreakIterator`](boundaryanalysis/index.md) services to help locate boundaries or
when counting units of text.
When checking characters for membership in a particular class, do not list the
specific characters you are interested in, and do not assume they come in any
particular order in the encoding scheme. For example, /A-Za-z/ does not mean all
letters in most European languages, and /0-9/ does not mean all digits in many
-writing systems. This also holds true when using C interfaces such as isupper()
-and islower. ICU provides a large group of utility functions for testing
-character properties, such as u_isupper and u_islower().
+writing systems. This also holds true when using C interfaces such as `isupper()`
+and `islower()`. ICU provides a large group of utility functions for testing
+character properties, such as `u_isupper` and `u_islower()`.
#### Text Input and Layout
@@ -220,7 +224,7 @@
Do not assume that all textual data, which the program stores and manipulates,
is in any particular language or writing system. ICU provides many methods that
-help with text storage. The UnicodeString class and u_strxxx functions are
+help with text storage. The `UnicodeString` class and u_strxxx functions are
provided for Unicode-based character manipulation. For example, when appending
an existing Unicode character buffer, characters can be removed or extracted out
of the buffer.
@@ -233,12 +237,10 @@
Time can be determined in many units, such as the lengths of months or years,
which day is the first day of the week, or the allowable range of values like
-month and year (with DateFormat). It can also determine the time zone you are in
-(with TimeZone), or when daylight-savings time starts. ICU provides the Calendar
+month and year (with `DateFormat`). It can also determine the time zone you are in
+(with `TimeZone`), or when daylight-savings time starts. ICU provides the Calendar
services needed to handle these issues.
-This example shows how a user interface element can be used to increment or
-decrement the time field value.
#### Distributed Locale Support