W3C home > Mailing lists > Public > public-media-capture-logs@w3.org > January 2017

Re: [mediacapture-fromelement] Migrate spec text to bikeshed.

From: Miguel Casas-Sanchez via GitHub <sysbot+gh@w3.org>
Date: Fri, 13 Jan 2017 01:12:01 +0000
To: public-media-capture-logs@w3.org
Message-ID: <issue_comment.created-272333620-1484269919-sysbot+gh@w3.org>
As another comparison, let me put together two paragraphs, one in the 
current Spec 
(https://github.com/w3c/mediacapture-fromelement/blob/gh-pages/index.html#L76):

```html
    <p>
      Both <code>MediaStream</code> and <code>HTMLMediaElement</code> 
expose the
      concept of a <q>track</q>.  Since there is no common type used 
for
      <code>HTMLMediaElement</code>, this document uses the term
      <dfn>track</dfn> to refer to either <code><dfn><a 
href="http://www.w3.org/TR/html5/embedded-content-0.html#videotrack">VideoTrack</a></dfn></code>
      or <code><dfn><a 
href="http://www.w3.org/TR/html5/embedded-content-0.html#audiotrack">AudioTrack</a></dfn></code>.
      <code><dfn><a 
href="https://w3c.github.io/mediacapture-main/#idl-def-MediaStreamTrack">MediaStreamTrack</a></dfn></code>
      is used to identify the media in a <code><dfn><a 
href="https://w3c.github.io/mediacapture-main/#idl-def-MediaStream">MediaStream</a></dfn></code>.
    </p>

```


versus Bikeshed:
```html

Both {{MediaStream}} and {{HTMLMediaElement}} expose the concept of a 
<code>track</code>. 
Since there is no common type used for {{HTMLMediaElement}}, this 
document uses the term
<dfn>track</dfn> to refer to either a {{VideoTrack}} or an 
{{AudioTrack}}.
{{MediaStreamTrack}}  is used to identify the media in a 
{{MediaStream}}.
```

@martinthomson, you mention as a negative point that Bikeshed needs an
 extra cycle of compilation, however the current Spec suffers from the
 possibility of uploading a Respec incomplete HTML, e.g. some `<dfn>`s
 are incomplete in the current Spec:
```html
No <dfn> for HTMLMediaElement.
No <dfn> for captureStream in HTMLCanvasElement.
No <dfn> for HTMLCanvasElement.
```
and 


-- 
GitHub Notification of comment by miguelao
Please view or discuss this issue at 
https://github.com/w3c/mediacapture-fromelement/pull/54#issuecomment-272333620
 using your GitHub account
Received on Friday, 13 January 2017 01:12:07 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 16:27:31 UTC