Update some docs.

README.md

@@ -163,41 +163,6 @@ const xml = minifyXML(
 ```
 
 ### Components
-Perhaps components should be in the style of HTML or JSX fragments.  I
-borrowed heavily from Svelte for this.
-
-```
-// This "<loom-module>" tag could be created automatically before inserting.
-<loom-module>
-  <script type="text/loom-module">
-    /**
-     * Key script features:
-     *  - Assume ES6?
-     *  - Maybe allow other languages that transpile to JS?
-     *  - Automatically sandbox css?
-     */
-
-  </script>
-
-  <ul>
-    <li>Allow multiple comment styles?</li>
-    <li>Plugin-based transformations (AST)</li>
-    <li>Some kind of script scoping</li>
-    <li></li>
-    <li></li>
-  </ul>
-
-  <style type="test/scss">
-    /**
-     * Key styling features:
-     * 
-     *  - Allow all three comment types here?  Make this a setting?
-     *  - Bake-in postcss transformers?  Maybe project-agnostic...
-     *  - Automatically sandbox css
-     */
-  </style>
-
-</loom-module>
-```
 
+See [the Components documentation](./docs/components.md).
 

docs/components.md

@@ -0,0 +1,44 @@
+# Components
+
+It is not at all clear to me that components should be in HTML.  It seems
+like a natural starting point, though, since we want to stay close to our
+bare-metal technologies.
+
+Perhaps components should be in the style of HTML or JSX fragments.  I
+borrowed heavily from Svelte for this.
+
+```
+// This "<loom-module>" tag could be created automatically before inserting.
+<loom-module>
+  <script type="text/loom-module">
+    /**
+     * Key script features:
+     *  - Assume ES6?
+     *  - Maybe allow other languages that transpile to JS?
+     *  - Automatically sandbox css?
+     */
+
+  </script>
+
+  <ul>
+    <li>Allow multiple comment styles?</li>
+    <li>Plugin-based transformations (AST)</li>
+    <li>Some kind of script scoping</li>
+    <li></li>
+    <li></li>
+  </ul>
+
+  <style type="test/scss">
+    /**
+     * Key styling features:
+     * 
+     *  - Allow all three comment types here?  Make this a setting?
+     *  - Bake-in postcss transformers?  Maybe project-agnostic...
+     *  - Automatically sandbox css
+     */
+  </style>
+
+</loom-module>
+```
+
+