Skip to content

Commit c3c213d

Browse files
authored
Add note about bidi for Tech Preview period (#692)
The working group discussed accepting #673 for the tech preview. Because this was a late-breaking change, the group decided to work on incorporating work on bidi and UAX31 conformance in the early post-45 period. I was tasked with creating a PR with a note about bidi for the Tech Preview specifically. This note is adapted from text proposed in #673.
1 parent 9caacb6 commit c3c213d

File tree

1 file changed

+15
-2
lines changed

1 file changed

+15
-2
lines changed

spec/syntax.md

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -97,14 +97,14 @@ Attempting to parse a _message_ that is not _valid_ will result in a _Data Model
9797

9898
A **_<dfn>message</dfn>_** is the complete template for a specific message formatting request.
9999

100-
> **Note**
100+
> [!NOTE]
101101
> This syntax is designed to be embeddable into many different programming languages and formats.
102102
> As such, it avoids constructs, such as character escapes, that are specific to any given file
103103
> format or processor.
104104
> In particular, it avoids using quote characters common to many file formats and formal languages
105105
> so that these do not need to be escaped in the body of a _message_.
106106
107-
> **Note**
107+
> [!NOTE]
108108
> In general (and except where required by the syntax), whitespace carries no meaning in the structure
109109
> of a _message_. While many of the examples in this spec are written on multiple lines, the formatting
110110
> shown is primarily for readability.
@@ -124,6 +124,19 @@ A **_<dfn>message</dfn>_** is the complete template for a specific message forma
124124
> >
125125
> > An exception to this is: whitespace inside a _pattern_ is **always** significant.
126126
127+
> [!NOTE]
128+
> The syntax assumes that each _message_ will be displayed with a left-to-right display order
129+
> and be processed in the logical character order.
130+
> The syntax also permits the use of right-to-left characters in _identifiers_,
131+
> _literals_, and other values.
132+
> This can result in confusion when viewing the _message_.
133+
>
134+
> Additional restrictions or requirements,
135+
> such as permitting the use of certain bidirectional control characters in the syntax,
136+
> might be added during the Tech Preview to better manage bidirectional text.
137+
> Feedback on the creation and management of _messages_
138+
> containing bidirectional tokens is strongly desired.
139+
127140
A _message_ can be a _simple message_ or it can be a _complex message_.
128141
129142
```abnf

0 commit comments

Comments
 (0)