28510 2015-04-19 02:52:46 +0000 [WebVTT] The spec should include feature explanations in plain language 2018-02-03 14:35:14 +0000 1 1 1 Unclassified TextTracks CG WebVTT unspecified PC All RESOLVED DUPLICATE 28408 widereview P2 normal --- 1 silviapfeiffer1 dave.null john.foliot philipj silviapfeiffer1 singer public-texttracks oldest_to_newest 119656 0 silviapfeiffer1 2015-04-19 02:52:46 +0000 Feedback from the HTML Accessibility Task force on WebVTT as per http://lists.w3.org/Archives/Public/public-tt/2015Apr/0049.html We are concerned that too often in this document a feature's function can only be understood by parsing the provided algorithms. We would prefer plain language explanations be included. A specific case in point would be Sec. 6.1. 119660 1 silviapfeiffer1 2015-04-19 03:36:04 +0000 Note related bug: https://www.w3.org/Bugs/Public/show_bug.cgi?id=28408 Section 6.1 has been resolved in the latest editor draft, see http://dev.w3.org/html5/webvtt/ , which was possible after some changes to the HTML specification were introduced. As for providing more "plain language explanations" - the WebVTT specification is mainly targeted at WebVTT UA and tool implementers and not at WebVTT authors (similar to the HTML specification). For author-related introductions, please refer e.g. to https://docs.webplatform.org/wiki/concepts/VTT_Captioning . 120769 2 silviapfeiffer1 2015-06-07 04:53:03 +0000 Marking as duplicate of bug 28408 since it also asks for improvement for authors. *** This bug has been marked as a duplicate of bug 28408 *** 127731 3 singer 2016-10-11 18:14:08 +0000 We rely on external documents to provide an authoring guide. 129068 4 singer 2018-02-02 23:31:43 +0000 The authoring guide was recovered from the sinking web platform docs and moved to the Wiki at https://www.w3.org/wiki/VTT_Concepts 129071 5 john.foliot 2018-02-03 14:35:14 +0000 MOVED TO GITHUB: https://github.com/w3c/webvtt/issues/427