This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 27009 - [InbandTracks] Term definitions
Summary: [InbandTracks] Term definitions
Status: NEW
Alias: None
Product: HTML WG
Classification: Unclassified
Component: Sourcing In-band Media Resource Tracks (show other bugs)
Version: unspecified
Hardware: PC Windows NT
: P2 normal
Target Milestone: ---
Assignee: Silvia Pfeiffer
QA Contact: HTML WG Bugzilla archive list
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2014-10-09 11:57 UTC by Cyril Concolato
Modified: 2014-10-09 11:57 UTC (History)
2 users (show)

See Also:


Attachments

Description Cyril Concolato 2014-10-09 11:57:27 UTC
The specification uses terms which are undefined or not clearly defined:
"track"
"in-band track"
"sourced track"
"media resource"
"media container"
The specification should either define them or reference a definition from another spec (e.g. HTML).

The specification is sometimes confusing when it uses the terms "track". It is unclear if it is talking about a track in the media container or a XXXXTrack object in the HTML JS API. In particular the use of upper case "Text Track" should be "TextTrack" as it refers to the JS Interface. It would be beneficial to the reader if the terms where linked to their definition and if special styles were used to visually differentiate defined terms from JS Interface.

I volunteer to do this editing. A possible example of changes (limited to the introduction for now) are given in this pull request:
https://github.com/w3c/HTMLSourcingInbandTracks/pull/26

The result can be viewed as a diff here:
http://services.w3.org/htmldiff?doc1=https%3A%2F%2Fraw.githubusercontent.com%2Fcconcolato%2FHTMLSourcingInbandTracks%2Fw3c%2Findex.html&doc2=https%3A%2F%2Fraw.githubusercontent.com%2Fcconcolato%2FHTMLSourcingInbandTracks%2Fmaster%2Findex.html