<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>27009</bug_id>
          
          <creation_ts>2014-10-09 11:57:27 +0000</creation_ts>
          <short_desc>[InbandTracks] Term definitions</short_desc>
          <delta_ts>2014-10-09 11:57:27 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>HTML WG</product>
          <component>Sourcing In-band Media Resource Tracks</component>
          <version>unspecified</version>
          <rep_platform>PC</rep_platform>
          <op_sys>Windows NT</op_sys>
          <bug_status>NEW</bug_status>
          <resolution></resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Cyril Concolato">cyril.concolato</reporter>
          <assigned_to name="Silvia Pfeiffer">silviapfeiffer1</assigned_to>
          <cc>mike</cc>
    
    <cc>public-html-admin</cc>
          
          <qa_contact name="HTML WG Bugzilla archive list">public-html-bugzilla</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>112884</commentid>
    <comment_count>0</comment_count>
    <who name="Cyril Concolato">cyril.concolato</who>
    <bug_when>2014-10-09 11:57:27 +0000</bug_when>
    <thetext>The specification uses terms which are undefined or not clearly defined:
&quot;track&quot;
&quot;in-band track&quot;
&quot;sourced track&quot;
&quot;media resource&quot;
&quot;media container&quot;
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 &quot;track&quot;. 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 &quot;Text Track&quot; should be &quot;TextTrack&quot; 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&amp;doc2=https%3A%2F%2Fraw.githubusercontent.com%2Fcconcolato%2FHTMLSourcingInbandTracks%2Fmaster%2Findex.html</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>