From b0f1a0db6332a61074806dae2ad836a16a3b5733 Mon Sep 17 00:00:00 2001
From: Guy Bedford <guybedford@gmail.com>
Date: Thu, 25 Jul 2019 17:11:12 -0400
Subject: [PATCH 1/4] include Appendix A media type registration

---
 spec.bs | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/spec.bs b/spec.bs
index 9c14ee2..868914e 100644
--- a/spec.bs
+++ b/spec.bs
@@ -569,3 +569,50 @@ Alternatively, we can add the snippet at the beginning of the following HTML spe
 </div>
 
 <p class="note">[=Validate a module script URL=] is applied to all module URLs before they start loading, even in paths where [=resolve a module specifier=] and import maps are not applied (e.g. `<script src="..." type="module">`).</p>
+
+<hr>
+<h2 id="internet-media-type-registration">Appendix A: Internet Media Type Registration</h2>
+
+This appendix provides the provisional registration of the Internet Media Type `application/importmap+json` in accordance with [[RFC6838]].
+
+: Type name:
+:: application
+: Subtype name:
+:: importmap+json
+: Required parameters:
+:: N/A
+: Optional parameters:
+:: N/A
+: Encoding considerations:
+:: 8bit
+: Security considerations:
+:: Since Import Maps have the ability to direct which module resolutions are to be provided to all ECMAScript module imports of a given ECMAScript environment, control of the Import Map should be considered to be execution-level application access. Integration with existing policy systems, including for example CORS and CSP, can be used to mitigate and restrict unwanted target URLs from being executed. In addition, the specification states that only those Import Maps served to browsers with the `application/importmap+json` MIME type will be executed.
+: Interoperability considerations:
+:: Backwards compatibility will be a necessity for any new features added to the format, and some handling for this has been incorporated into the design of the specification.
+: Published specification:
+:: https://wicg.github.io/import-maps/
+: Applications that use this media type:
+:: This is a browser-specific MIME type but may also apply to other ECMAScript environments.
+: Fragment identifier considerations:
+:: N/A
+: Restrictions on usage:
+:: N/A
+: Additional information:
+: Deprecated alias names for this type:
+:: N/A
+: Magic number(s)
+:: N/A
+: File extension(s):
+:: .importmap
+: Macintosh file type code:
+:: N/A
+: Object Identifiers:
+:: N/A
+: Person & email address to contact for further information:
+:: Guy Bedford (guybedford@gmail.com).
+: Intended usage:
+:: COMMON
+: Restrictions on usage:
+:: N/A
+: Change controller:
+:: W3C

From f7bf0d13f4c903e11c84e449396f454b9872687a Mon Sep 17 00:00:00 2001
From: Guy Bedford <guybedford@gmail.com>
Date: Tue, 30 Jul 2019 16:47:05 -0400
Subject: [PATCH 2/4] review feedback

---
 spec.bs | 38 +++++++++++++++++---------------------
 1 file changed, 17 insertions(+), 21 deletions(-)

diff --git a/spec.bs b/spec.bs
index 868914e..882b4e8 100644
--- a/spec.bs
+++ b/spec.bs
@@ -571,9 +571,9 @@ Alternatively, we can add the snippet at the beginning of the following HTML spe
 <p class="note">[=Validate a module script URL=] is applied to all module URLs before they start loading, even in paths where [=resolve a module specifier=] and import maps are not applied (e.g. `<script src="..." type="module">`).</p>
 
 <hr>
-<h2 id="internet-media-type-registration">Appendix A: Internet Media Type Registration</h2>
+<h2 id="internet-media-type-registration">Appendix A: MIME type registration</h2>
 
-This appendix provides the provisional registration of the Internet Media Type `application/importmap+json` in accordance with [[RFC6838]].
+This appendix provides the provisional registration of the [=MIME type=] <dfn export>`application/importmap+json`</dfn> `application/importmap+json` in accordance with [[RFC6838]].
 
 : Type name:
 :: application
@@ -584,35 +584,31 @@ This appendix provides the provisional registration of the Internet Media Type `
 : Optional parameters:
 :: N/A
 : Encoding considerations:
-:: 8bit
+:: 8bit (always UTF-8)
 : Security considerations:
-:: Since Import Maps have the ability to direct which module resolutions are to be provided to all ECMAScript module imports of a given ECMAScript environment, control of the Import Map should be considered to be execution-level application access. Integration with existing policy systems, including for example CORS and CSP, can be used to mitigate and restrict unwanted target URLs from being executed. In addition, the specification states that only those Import Maps served to browsers with the `application/importmap+json` MIME type will be executed.
+:: Since Import Maps have the ability to direct which module resolutions are to be provided to all ECMAScript module imports of a given JavaScript environment, control of the Import Map should be considered to be execution-level application access. Integration with existing policy systems, including for example CORS and CSP, can be used to mitigate and restrict unwanted target URLs from being executed. In addition, the specification states that only those Import Maps served to browsers with the `application/importmap+json` MIME type will be executed. [[FETCH]] [[CSP]]
 : Interoperability considerations:
-:: Backwards compatibility will be a necessity for any new features added to the format, and some handling for this has been incorporated into the design of the specification.
+:: Backwards compatibility will be a necessity for any new features added to the format, and handling for this has been incorporated into the design of the specification.
 : Published specification:
 :: https://wicg.github.io/import-maps/
 : Applications that use this media type:
-:: This is a browser-specific MIME type but may also apply to other ECMAScript environments.
+:: This is a browser-specific MIME type but may also apply to other JavaScript environments.
 : Fragment identifier considerations:
 :: N/A
-: Restrictions on usage:
-:: N/A
 : Additional information:
-: Deprecated alias names for this type:
-:: N/A
-: Magic number(s)
-:: N/A
-: File extension(s):
-:: .importmap
-: Macintosh file type code:
-:: N/A
-: Object Identifiers:
-:: N/A
+  : Deprecated alias names for this type:
+  :: N/A
+  : Magic number(s)
+  :: N/A
+  : File extension(s):
+  :: "importmap"
+  : Macintosh file type code:
+  :: Same as for `application/json` [[=JSON=]]
 : Person & email address to contact for further information:
-:: Guy Bedford (guybedford@gmail.com).
+:: Guy Bedford &lt;guybedford@gmail.com>.
 : Intended usage:
-:: COMMON
+:: Common
 : Restrictions on usage:
-:: N/A
+:: No restrictions apply.
 : Change controller:
 :: W3C

From 245d812211e457248f632f8cd0336db7015f4d44 Mon Sep 17 00:00:00 2001
From: Guy Bedford <guybedford@gmail.com>
Date: Tue, 30 Jul 2019 19:48:38 -0400
Subject: [PATCH 3/4] update change controller and nesting

---
 spec.bs | 22 +++++++++++++---------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/spec.bs b/spec.bs
index 882b4e8..51d49af 100644
--- a/spec.bs
+++ b/spec.bs
@@ -596,14 +596,18 @@ This appendix provides the provisional registration of the [=MIME type=] <dfn ex
 : Fragment identifier considerations:
 :: N/A
 : Additional information:
-  : Deprecated alias names for this type:
-  :: N/A
-  : Magic number(s)
-  :: N/A
-  : File extension(s):
-  :: "importmap"
-  : Macintosh file type code:
-  :: Same as for `application/json` [[=JSON=]]
+  <dd>
+    <dl>
+      : Deprecated alias names for this type:
+      :: N/A
+      : Magic number(s)
+      :: N/A
+      : File extension(s):
+      :: "importmap"
+      : Macintosh file type code:
+      :: Same as for `application/json` [[JSON]]
+    </dl>
+  </dd>
 : Person & email address to contact for further information:
 :: Guy Bedford &lt;guybedford@gmail.com>.
 : Intended usage:
@@ -611,4 +615,4 @@ This appendix provides the provisional registration of the [=MIME type=] <dfn ex
 : Restrictions on usage:
 :: No restrictions apply.
 : Change controller:
-:: W3C
+:: WHATWG

From 7a195ce8e58c548430a67f1c240c9b9b27b13fee Mon Sep 17 00:00:00 2001
From: Guy Bedford <guybedford@gmail.com>
Date: Tue, 30 Jul 2019 19:55:38 -0400
Subject: [PATCH 4/4] remove further ECMAScript reference

---
 spec.bs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/spec.bs b/spec.bs
index 51d49af..075e935 100644
--- a/spec.bs
+++ b/spec.bs
@@ -586,7 +586,7 @@ This appendix provides the provisional registration of the [=MIME type=] <dfn ex
 : Encoding considerations:
 :: 8bit (always UTF-8)
 : Security considerations:
-:: Since Import Maps have the ability to direct which module resolutions are to be provided to all ECMAScript module imports of a given JavaScript environment, control of the Import Map should be considered to be execution-level application access. Integration with existing policy systems, including for example CORS and CSP, can be used to mitigate and restrict unwanted target URLs from being executed. In addition, the specification states that only those Import Maps served to browsers with the `application/importmap+json` MIME type will be executed. [[FETCH]] [[CSP]]
+:: Since Import Maps have the ability to direct which module resolutions are to be provided to all module imports of a given JavaScript environment, control of the Import Map should be considered to be execution-level application access. Integration with existing policy systems, including for example CORS and CSP, can be used to mitigate and restrict unwanted target URLs from being executed. In addition, the specification states that only those Import Maps served to browsers with the `application/importmap+json` MIME type will be executed. [[FETCH]] [[CSP]]
 : Interoperability considerations:
 :: Backwards compatibility will be a necessity for any new features added to the format, and handling for this has been incorporated into the design of the specification.
 : Published specification: