28254 2015-03-21 23:58:46 +0000 [webvtt] term "NOTE" may not be friendly to users in other languages [I18N-ISSUE-419] 2015-11-24 13:05:07 +0000 1 1 1 Unclassified TextTracks CG WebVTT unspecified PC All RESOLVED WONTFIX widereview changeDeclined, decided P2 normal --- 1 silviapfeiffer1 dave.null addison philipj silviapfeiffer1 singer zcorpan public-texttracks oldest_to_newest 118766 0 silviapfeiffer1 2015-03-21 23:58:46 +0000 Feedback by Addison Phillips from W3C I18N group: http://lists.w3.org/Archives/Public/public-tt/2015Mar/0053.html I18N comment: https://www.w3.org/International/track/issues/419 This is a comment on: http://www.w3.org/TR/webvtt1/#comments Comments in a WebVTT file are introduced by the string "NOTE" in English. This serves as the same kind of marker that tokens such as # or // or /* */ do in some programming languages or formats. Using an English word is less accessible for international/non-English users than the use of a symbolic token. 118831 1 philipj 2015-03-23 01:40:53 +0000 The same is going to be true of STYLE, and is true of all cue and region settings. 118854 2 zcorpan 2015-03-23 07:53:02 +0000 Why is it less accesible? That it is an English word doesn't mean they need to know English or know the word to use it and know what it does in WebVTT. Also, as Philip said, this is all over the place; other than WebVTT we also have this "issue" in HTML, SVG, CSS, JavaScript, HTTP... 120350 3 singer 2015-05-18 23:46:17 +0000 The VTT language itself is not suppoed to be international or internationalized; suggest 'wontfix' 120356 4 philipj 2015-05-19 08:48:36 +0000 WONTFIX it is 124272 5 addison 2015-11-23 18:14:46 +0000 I disagree vehemently with the statement that the "VTT language is not supposed to be international or internationalized" because I firmly believe you intend for the language to be used globally and for the language to support the needs of users world-wide (that is, it is internationalized). But I don't believe this is what you mean by your comment in response. Despite what I'm going to say below, I'm not going to change the status of this bug and I'm going to close the I18N issue in tracker. You choice of adopting an English keyword is a defensible design decision and does not impede the above internationalization goals. However, I do want to make the design point I was making clearer. Many programming and markup languages use English/ASCII keywords (what Charmod-Norm calls a "vocabulary") and that is a reasonable design choice. But this doesn't necessarily mean that every keyword needs to be an English word--or even a word. Comments, in particular, tend not to be introduced with words and use symbolic markup instead. In this case, the note keyword appears to participate in the message when you are reading the file--in English: NOTE I meant to do this. And seems less natural when it looks like: NOTE Je voulais le faire. Since there exist a large number of non-word tokens that are well-understood in computing or markup contexts to be introducing a comment, I tend to favor adopting one of them instead. // Je voulais le faire. # Je voulais le faire. <!-- Je voulais le faire --> ... etc. 124282 6 zcorpan 2015-11-24 13:05:07 +0000 I see your point, but the existing syntaxes are problematic because they carry assumptions that would not hold in WebVTT: (In reply to Addison Phillips from comment #5) > // Je voulais le faire. > # Je voulais le faire. These are typically line comments, but WebVTT comments are blocks that are terminated at a blank line or at a line containing "-->". > <!-- Je voulais le faire --> This and /* */ are multiline comments where you can comment out an arbitrary number of lines, but this is not possible in WebVTT either. A non-word syntax I think would work would be to prefix each line with "-->". That makes each line be a block, and it removes the restriction that comments can't contain "-->". It also makes it more obvious how to comment out cues and other blocks. WEBVTT --> I meant to do this. --> Je voulais le faire. --> I can use -->! --> STYLE --> ::cue { ... } --> FIXME The commented out cue below is wrong --> 00:00:00.000 --> 00:00.10.000 --> Hello wrold This text is still part of the comment block, but it's a syntax violation because it's not clear where the comment ends, and if it uses a --> somewhere, that would start a new block. If you (or anyone else) think this would be much awesomer than NOTE, I suppose we can reopen.