28408 2015-04-06 01:57:57 +0000 [WebVTT] Consider reorganising the Rendering section 2017-07-10 06:20:20 +0000 1 1 1 Unclassified TextTracks CG WebVTT unspecified PC All RESOLVED MOVED widereview P2 normal --- 1 silviapfeiffer1 dave.null nigel.megitt philipj silviapfeiffer1 singer tai zcorpan public-texttracks oldest_to_newest 119242 0 silviapfeiffer1 2015-04-06 01:57:57 +0000 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. 120770 1 silviapfeiffer1 2015-06-07 04:53:04 +0000 *** Bug 28510 has been marked as a duplicate of this bug. *** 127710 2 singer 2016-10-11 16:29:52 +0000 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. 127829 3 zcorpan 2016-10-18 11:44:06 +0000 https://github.com/w3c/webvtt/issues/313 128685 4 tai 2017-07-10 06:20:20 +0000 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.