Skip to content

Commit 37daadb

Browse files
committed
Fix example text in i18n section.
1 parent 905fec0 commit 37daadb

File tree

1 file changed

+16
-10
lines changed

1 file changed

+16
-10
lines changed

index.html

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -4737,7 +4737,7 @@ <h2>Internationalization Considerations</h2>
47374737
This section outlines general internationalization considerations to take into
47384738
account when utilizing this data model and is intended to highlight specific
47394739
parts of the <em>Strings on the Web: Language and Direction Metadata</em>
4740-
document [[STRING-META]] that implementers might be interested in perusing.
4740+
document [[STRING-META]] that implementers might be interested in reading.
47414741
</p>
47424742

47434743
<section class="informative">
@@ -4767,29 +4767,35 @@ <h3>Language and Base Direction</h3>
47674767

47684768
<p>
47694769
An example utilizing the design pattern above is shown below to express the
4770-
human-readable text "revoked" in the English language without specifying a
4771-
text direction:
4770+
title of a book in the English language without specifying a text direction:
47724771
</p>
47734772

47744773
<pre class="example nohighlight" title="Expressing natural language text as English">
4775-
"statusReason": {
4776-
"value": "<span class="highlight">Revoked</span>",
4774+
"title": {
4775+
"value": "<span class="highlight">HTML and CSS: Designing and Creating Websites</span>",
47774776
"lang": "<code>en</code>"
47784777
}
47794778
</pre>
47804779

47814780
<p>
4782-
The next example uses a term in Arabic with a base direction of right-to-left:
4781+
The next example uses a similar title expressed in the Arabic language with a
4782+
base direction of right-to-left:
47834783
</p>
47844784

47854785
<pre class="example nohighlight" title="Arabic text with a base direction of right-to-left">
4786-
"statusReason": {
4787-
"value": "<span class="highlight">إلغاء</span>",
4786+
"title": {
4787+
"value": "<span class="highlight">HTML و CSS: تصميم و إنشاء مواقع الويب</span>",
47884788
"lang": "<code>ar</code>"
47894789
"dir": "<code>rtl</code>"
47904790
}
47914791
</pre>
47924792

4793+
<p class="note">
4794+
The text above would most likley be rendered incorrectly as left to right
4795+
without the explicit expression of language and direction as many systems will
4796+
use the first character of a text string to determine text direction.
4797+
<p>
4798+
47934799
<p>
47944800
Utilization of the design pattern above assumes that the JSON-LD
47954801
<a href="#extensibility">extension</a> associated with the
@@ -4801,9 +4807,9 @@ <h3>Language and Base Direction</h3>
48014807
</p>
48024808

48034809
<pre class="example nohighlight" title="Specifying scoped aliasing for language information">
4804-
"statusReason": {
4810+
"title": {
48054811
<span class="highlight">"@context": {"value": "@value", "lang": "@language", "dir": "@direction"}</span>,
4806-
"@id": "https://www.w3.org/2018/credentials/examples#statusReason"
4812+
"@id": "https://www.w3.org/2018/credentials/examples#title"
48074813
}
48084814
</pre>
48094815

0 commit comments

Comments
 (0)