[webvtt] The spec should include feature explanations in plain language (Moved from Bugzilla)

johnfoliot has just created a new issue for https://github.com/w3c/webvtt:

== The spec should include feature explanations in plain language (Moved from Bugzilla) ==
> Reply: no change, we rely on external documents to provide an
authoring guide.

**APA Response:** There are actually 2 responses here.

The first is related to an on-going request from APA that W3C Technical
Recommendations also include, when and where necessary, prose summaries in
"plain english" that explain features and functions of the various parts
of any given spec. The intent here is to explain what is happening with the
technology in lay terms, rather than explain how to create content using
the technology. (i.e.: don't just show an API [sic], explain it.) This
remains an important request from APA, but is not a blocking issue.

The second response is related to Authoring Guidance documents (referenced
in your reply). Following up on the Bug Tracker, it shows a link to an
authoring guidance document (
https://docs.webplatform.org/wiki/concepts/VTT_Captioning), yet that URL
returns a 404 today.

   - Has this document been relocated elsewhere? If yes, can we please have
   the reference URL. If no, does the WG plan on updating/recreating this
   document? (This also ties-back to Item #1)

   - The current WebVTT Working Draft (https://www.w3.org/TR/webvtt1)
   currently has 'editorial guidance' as part of the normative specification
   addressing privacy and security, and APA's request is that editorial
   guidance for accessibility considerations also be provided in the same
   fashion (i.e. directly in the Rec, as opposed to linking out.)


APA would be pleased to assist in the review of any authoring guidance that
emerges from the WebVTT WG.

Please view or discuss this issue at https://github.com/w3c/webvtt/issues/427 using your GitHub account

Received on Saturday, 3 February 2018 14:34:21 UTC