Automatically generate props documentation from types

babel.config.js

@@ -1,15 +1,25 @@
-module.exports =
-  process.env.NODE_ENV === 'test'
-    ? {
-        presets: [
-          [
-            '@babel/preset-env',
-            {
-              targets: {
-                node: 'current',
-              },
-            },
-          ],
-        ],
-      }
-    : {}
+var value = {}
+
+if (process.env.NODE_ENV === 'test') {
+  value = {
+    presets: [
+      [
+        '@babel/preset-env',
+        {
+          targets: {
+            node: 'current',
+          },
+        },
+      ],
+    ],
+  }
+} else if (process.env.NODE_ENV === 'docs') {
+  value = {
+    presets: [
+      '@babel/preset-env',
+      '@babel/preset-react',
+      '@babel/preset-typescript',
+    ],
+  }
+}
+module.exports = value

docs/README.md

@@ -0,0 +1,29 @@
+# carbonplan / maps / docs
+
+**docs site for `@carbonplan/maps` — [live](https://maps.docs.carbonplan.org/maps)**
+
+## development
+
+Assuming you already have `Node.js` installed, you can install the build dependencies as:
+
+```shell
+npm install .
+```
+
+To start a development version of the site, simply run:
+
+```shell
+npm run dev
+```
+
+and then visit `http://localhost:3001/maps` in your browser.
+
+### prop types
+
+The docs site uses the automatically generated prop definitions in `components/component-props.json` to render `PropsTable`s typed components. To regenerate these prop definitions in the main `maps` project, you can run:
+
+```shell
+npm run build-docs
+```
+
+and check in the updates to `component-props.json`.