[Bug 18786] New: Improve special characters readability in the specifications

https://www.w3.org/Bugs/Public/show_bug.cgi?id=18786

           Summary: Improve special characters readability in the
                    specifications
           Product: TextTracks CG
           Version: unspecified
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: enhancement
          Priority: P2
         Component: WebVTT
        AssignedTo: ian@hixie.ch
        ReportedBy: ubitux@gmail.com
         QAContact: dave.null@w3.org
                CC: mike@w3.org, public-texttracks@w3.org


Just a small suggestion about the specifications; would it be possible to put a
particular markup on the characters code?

Example: the sentence "Optionally, either a U+0020 SPACE character or a U+0009
CHARACTER TABULATION (tab) character followed by any number of characters that
are not U+000A LINE FEED (LF) or U+000D CARRIAGE RETURN (CR) characters."

...is quite unreadable in the current form. It would IMO be greatly improved by
using for example: "Optionally, either a <code>U+0020 SPACE</code> character or
a <code>U+0009 CHARACTER TABULATION (tab)</code> character followed by any
number of characters that are not <code>U+000A LINE FEED (LF)</code> or
<code>U+000D CARRIAGE RETURN (CR)</code> characters."

(or any other particular emphasis)


Somehow related: it looks like there are both mixed ASCII and UTF-8 characters
wording in this section:
http://dev.w3.org/html5/webvtt/#webvtt-chapter-title-text

ASCII:
    A WebVTT cue amp escape, representing a "&" character in the text of the
cue.
    A WebVTT cue lt escape, representing a "<" character in the text of the
cue.
    A WebVTT cue gt escape, representing a ">" character in the text of the
cue.

UTF-8:
    A WebVTT cue lrm escape, representing a U+200E LEFT-TO-RIGHT MARK Unicode
bidirectional formatting character in the text of the cue.
    A WebVTT cue rlm escape, representing a U+200F RIGHT-TO-LEFT MARK Unicode
bidirectional formatting character in the text of the cue.
    A WebVTT cue nbsp escape, representing a U+00A0 NO-BREAK SPACE character in
the text of the cue.

-- 
Configure bugmail: https://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are on the CC list for the bug.

Received on Thursday, 6 September 2012 01:04:13 UTC