docs: ✏️ clarify production build process and asset location

README.md

@@ -100,6 +100,11 @@ To autogenerate a ToC (table of contents) for this README,
 run `yarn doc:toc`.  Please update the ToC whenever editing the structure
 of README.
 
+### Building Core UI for Production
+
+See ui/core/README.md Building for Production for more information on how to
+build the Core UI.
+
 ### Committing
 
 Instead of the default `git commit`, we prescribe a custom command that ensures

ui/core/README.md

@@ -58,12 +58,18 @@ List of available project commands.  `yarn run <command-name>`
 * Visit your app at [http://localhost:4200](http://localhost:4200).
 * Visit your tests at [http://localhost:4200/tests](http://localhost:4200/tests).
 
-### Building
+### Building for Production
 
-To build the project, without running it, execute one of the following commands:
+Before executing a build, be sure to set any environment variables necessary
+for your target environment (see next section).  To build this UI for
+production, run the following commads from this folder:
 
-* `yarn run build` (development)
-* `yarn run build:production` (production)
+```bash
+yarn install
+yarn build:production
+```
+
+The static production assets are saved into the `dist/` folder.
 
 #### Environment Variables