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

Ah excellent - I thought you might have missed it because I didn't receive
a reply email. ;-)

Anyway, I just checked and found some typos that you may want to correct:

1. Typo: missed a "by"
s/Optional Cue Settings separated from the time one or more SPACE or TAB
characters/Optional Cue Settings separated from the time by one or more
SPACE or TAB characters/

2. Non-readable sentences:
"Using timestamp tags can build Karaoke Style tracks."
I think you mean something like:
"Timestamp tags can be used to build Karaoke style tracks."

3. Typo: missed "are"
s/Timestamp tags can also be used for Paint On captions, which placed
independently from each other and don't erase what was already on the
screen/Timestamp tags can also be used for Paint On captions, which are
placed independently from each other and don't erase what was already on
the screen/

Other than that, it's really looking awesome!

Cheers,
Silvia.



On Sun, Jan 12, 2014 at 11:17 AM, Carlos Araya <carlos.araya@gmail.com>wrote:

> Silvia,
>
> Yes, I incorporated all feedback received on this thread into the
> document.  Is there something I missed?
>
> Carlos
> On Jan 11, 2014, at 4:10 PM, Silvia Pfeiffer <silviapfeiffer1@gmail.com>
> wrote:
>
> Hi Carlos,
>
> I gave you feedback on the other thread - has that been incorporated?
>
> Thanks,
> Silvia.
>
>
>
> On Sun, Jan 12, 2014 at 9:04 AM, Carlos Araya <carlos.araya@gmail.com>wrote:
>
>> 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.
>>>>>>> >>
>>>>>>> >>
>>>>>>>
>>>>>>
>>>>>>
>>>>>
>>>>
>>>
>>
>
>