This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.
Andreas Tai wrote: "It is an interesting approach to provide different sections to different target groups (e.g. WebVTT authors and WebVTT parser implementers) so they do not have to read the complete spec. My experience is (after reading different versions of WebVTT) that even for a specific task it is difficult to get the necessary information without reading through the complete spec." Specifically, we encourage authors to focus on the Syntax section and ignore the Parsing section, which targets implementers. Yet, the Rendering section is a mix that both target groups have to read with different needs. It might be worth pulling that section apart into a "Styling syntax" section and keep the remainder as "Rendering Process". The "Styling syntax" would go before the Parsing section - could even be part of the "Syntax" section.
*** Bug 28510 has been marked as a duplicate of this bug. ***
Notes that 6 only has one subsection, 6.1, and we could therefore hoist everything up one level. Suggest that the CSS extensions should be a separate top-level section, preceding rendering.
https://github.com/w3c/webvtt/issues/313
Thanks for adding the additional informative section which is a good guidance for authors. There may be small improvements possible how this section is referred to in previous sections of the draft and I also have some comments regarding the general status of CSS extensions, but this need a complete review of the current spec and will be opened as separate issues.