From 7c1507b9c178bbeedf9671a11b4b070c3298cae7 Mon Sep 17 00:00:00 2001
From: Dean Jackson <dino@apple.com>
Date: Wed, 15 Dec 2021 09:38:39 +1100
Subject: [PATCH] [model] Add `media` attribute to `source` element

Closes #75.
---
 model/README.md | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/model/README.md b/model/README.md
index f366383..a5241b5 100644
--- a/model/README.md
+++ b/model/README.md
@@ -78,9 +78,12 @@ element similar to `<video>` in that it is replaced visually by the content
 of an external resource referenced via a `<source>` element. Like other
 HTML elements, it can be styled using CSS.
 
-The resource is resolved by selecting the first `<source>` elements with a
-supported `type` attribute, allowing different versions of the same
-resource in different formats to be specified.
+The resource is resolved by selecting the first, most appropriate `<source>`
+element with supported `type` and `media` attributes, allowing different versions of the same
+resource in different formats to be specified. See the HTML specification for
+the definition of
+[type](https://html.spec.whatwg.org/multipage/embedded-content.html#attr-source-type) and
+[media](https://html.spec.whatwg.org/multipage/embedded-content.html#attr-source-media).
 
 This is an example showing how a
 [USDZ](https://graphics.pixar.com/usd/docs/Usdz-File-Format-Specification.html)