Placing Tutorials (was Re: VTT authoring guide on Web Platform Docs?)

I think I'm good with the tutorial.  It could use one more round of
feedback before moving it to the WPD site.

That bring another question, what is the best place for the VTT tutorial
within the WPD doc web site? I haven't made up my mind if it falls under
HTML, Accessibility or general web concepts.

Any ideas?

Carlos


On Tue, Dec 17, 2013 at 11:08 AM, Carlos Araya <carlos.araya@gmail.com>wrote:

> Jay,
>
> I added the links as notes to the supported browsers table.  Can you think
> of a better placement for the links?
>
> Carlos
>
>
> On Sun, Dec 15, 2013 at 12:28 PM, Jay Munro <jaymunro@microsoft.com>wrote:
>
>>   Hi Carlos,
>>
>>
>>
>> Looks good, though here's a bit more:
>>
>>
>>
>> Under IE, you've got documentation on the HTML5 Rocks site. While a good
>> site, Microsoft has a lot of Text Track docs, with a number of examples.
>>
>>
>>
>> This is our technology start page:
>>
>> http://msdn.microsoft.com/library/ie/bg123962.aspx
>>
>>
>>
>> Here's where all the API docs are. The text track API is mixed in with
>> the audio/video/media elements.
>>
>> http://msdn.microsoft.com/en-US/library/ie/hh772500.aspx
>>
>>
>>
>> There's a set of text track samples here, including one that uses meta
>> data to create a slide show. MSDN locks us out of actually having the demo
>> online, so it might be a good candidate to put on WebPlatform.
>>
>> http://code.msdn.microsoft.com/ie/HTML5-Timed-Text-Track-9fddea75
>>
>>
>>
>> Lastly, though a little dated, there's a demo on ietestdrive.com that
>> has an editor that will create WebVTT files (as well as TTML files). I've
>> been meaning to get around to an update, but things have been busy.
>>
>> http://ie.microsoft.com/testdrive/Graphics/CaptionMaker/
>>
>>
>>
>>    IE HTML5 Timed Text Track sample in JavaScript, HTML for Visual
>> Studio 2010
>>  The examples shown here use the HTML5 track element, and show you how to
>> add video with captioning and other features to your webpages.
>>  Read more...<http://code.msdn.microsoft.com/ie/HTML5-Timed-Text-Track-9fddea75>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>  ------------------------------
>> *From:* Carlos Araya <carlos.araya@gmail.com>
>> *Sent:* Saturday, December 14, 2013 10:59 AM
>> *To:* Richard Eyre
>> *Cc:* Silvia Pfeiffer; David Singer; public-webplatform@w3.org;
>> public-texttracks@w3.org; Doug Schepers
>>
>> *Subject:* Re: VTT authoring guide on Web Platform Docs?
>>
>>   Richard,
>>
>>  Thank you for the feedback.
>>
>>  I've updated the information regarding Firefox Nightly and added  vtt.js
>> to the lists of players and polyfills.
>>
>>
>> What bug should I track for Cue formatting issues?
>>
>>
>> Carlos
>>
>>
>> On Thu, Dec 12, 2013 at 5:38 PM, Richard Eyre <rick.eyre@hotmail.com>wrote:
>>
>>> I'm not sure if this got through to the list so if it did, apologies. I
>>> don't mean to spam the list.
>>>
>>>
>>> Looks good at a quick pass Carlos. Two things:
>>>
>>> * Firefox Nightly is enabled by default now. A patch landed a few days
>>> ago for that.
>>> * Underneath the polyfill section you can list
>>> https://github.com/mozilla/vtt.js. It's a JavaScript implementation of
>>> the WebVTT spec (not the track spec). In the future it might evolve into a
>>> full <track> polyfill.
>>>
>>>  Rick
>>>
>>>
>>> On Thu, Dec 12, 2013 at 7:17 PM, Carlos Araya <carlos.araya@gmail.com>wrote:
>>>
>>>> I took a first stab at writing the VTT tutorial. It's currently hosted
>>>> in Github to make it easier for people to contribute examples and edits to
>>>> the page.
>>>>
>>>>
>>>> https://github.com/caraya/vtt-demos/blob/master/video_captioning.md
>>>>
>>>>
>>>> Please take a look at it and let me know what you think needs to be
>>>> changed and what other things I should add.
>>>>
>>>>
>>>> Carlos
>>>>
>>>>
>>>> On Thu, Dec 5, 2013 at 6:00 PM, Silvia Pfeiffer <
>>>> silviapfeiffer1@gmail.com> wrote:
>>>>
>>>>> Great to hear your interest!
>>>>>
>>>>> I would indeed encourage to write about implemented reality, even
>>>>> though that will probably continue to improve over the next few
>>>>> months.
>>>>>
>>>>> You could explain the features as specified and then explain what
>>>>> works in the browsers now.
>>>>>
>>>>> This could, in fact, contribute to the testing efforts of the <track>
>>>>> element in HTML, see http://www.w3.org/html/wg/wiki/Testing .
>>>>>
>>>>> Cheers,
>>>>> Silvia.
>>>>>
>>>>>
>>>>>
>>>>> On Fri, Dec 6, 2013 at 12:44 PM, Carlos Araya <carlos.araya@gmail.com>
>>>>> wrote:
>>>>> > I'd be interested in looking at working on something like this.
>>>>> However the first question that comes to mind is whether we write to the
>>>>> way the specification is written or to the way it is supported. As far as I
>>>>> know there is no complete implementation of the VTT spec available,is there?
>>>>> >
>>>>> >
>>>>> > Carlos
>>>>> >
>>>>> > Sent from my iPad
>>>>> >
>>>>> >> On Dec 5, 2013, at 12:43 PM, David Singer <singer@apple.com> wrote:
>>>>> >>
>>>>> >> Hi
>>>>> >>
>>>>> >> it would be really cool to have an authoring guide for VTT (unlike
>>>>> the specification, which is essentially an implementation guide) on
>>>>> WebPlatformDocs.  There are some possible starting points, below, though of
>>>>> course to use any of this material we’d need to work with the authors and
>>>>> get permission.
>>>>> >>
>>>>> >> Is there someone who would like to pull this together and spearhead
>>>>> getting a good authoring guide on this important site?
>>>>> >>
>>>>> >>
>>>>> >>
>>>>> >>>
>>>>> http://dev.opera.com/articles/view/an-introduction-to-webvtt-and-track/
>>>>> >>> http://developer.mozilla.org/en-US/docs/HTML/WebVTT
>>>>> >>>
>>>>> http://blogs.msdn.com/b/ie/archive/2011/10/12/html5-video-captioning.aspx
>>>>> >>> http://www.delphiki.com/webvtt/
>>>>> >>>
>>>>> http://demosthenes.info/blog/580/Make-Online-Video-Accessible-And-Searchable-With-WebVTT
>>>>> >>>
>>>>> http://www.accessiq.org/news/features/2013/03/webvtt-and-captioning-on-the-web
>>>>> >>
>>>>> >> David Singer
>>>>> >> Multimedia and Software Standards, Apple Inc.
>>>>> >>
>>>>> >>
>>>>>
>>>>
>>>>
>>>
>>
>