This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 28510 - [WebVTT] The spec should include feature explanations in plain language
Summary: [WebVTT] The spec should include feature explanations in plain language
Status: RESOLVED DUPLICATE of bug 28408
Alias: None
Product: TextTracks CG
Classification: Unclassified
Component: WebVTT (show other bugs)
Version: unspecified
Hardware: PC All
: P2 normal
Target Milestone: ---
Assignee: This bug has no owner yet - up for the taking
QA Contact: Web Media Text Tracks CG
URL:
Whiteboard: widereview
Keywords:
Depends on:
Blocks:
 
Reported: 2015-04-19 02:52 UTC by Silvia Pfeiffer
Modified: 2018-02-03 14:35 UTC (History)
4 users (show)

See Also:


Attachments

Description Silvia Pfeiffer 2015-04-19 02:52:46 UTC
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.
Comment 1 Silvia Pfeiffer 2015-04-19 03:36:04 UTC
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 .
Comment 2 Silvia Pfeiffer 2015-06-07 04:53:03 UTC
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 ***
Comment 3 David Singer 2016-10-11 18:14:08 UTC
We rely on external documents to provide an authoring guide.
Comment 4 David Singer 2018-02-02 23:31:43 UTC
The authoring guide was recovered from the sinking web platform docs and moved to the Wiki at https://www.w3.org/wiki/VTT_Concepts
Comment 5 John Foliot 2018-02-03 14:35:14 UTC
MOVED TO GITHUB: https://github.com/w3c/webvtt/issues/427