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

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