how it works

docs/latest/deployment/recipes/build-for-production.md

@@ -33,8 +33,8 @@ _From .zip:_
 
 ### Restore Dependencies & Build
 
-Open PowerShell, Terminal, or a Command Prompt, and navigate to the directory
-containing the source files. Next run these commands:
+Open your terminal, and navigate to the directory containing the source files.
+Next run these commands:
 
 ```js
 // Restore dependencies
@@ -64,11 +64,37 @@ how to configure the project for your own imaging archive below.
 
 ### Configuration
 
-...
+> This step assumes you have an imaging archive. If you need assistance setting
+> one up, check out the [`Data` section](./../index.md#data) of our Deployment
+> Guide, or `Getting Started`'s
+> ["Set up a local DICOM server"](./../../essentials/getting-started.md#set-up-a-local-dicom-server),
+> or a deployment recipe that contains an open source Image Archive
 
-- env vars
-- `REACT_APP_*`
-- config file(s)
+#### How It Works
+
+The configuration for our project is in the `/public/config` directory. Our
+build process knows which configuration file to use based on the
+`REACT_APP_CONFIG` environment variable. By default, its value is
+[`default.js`](https://github.com/OHIF/Viewers/blob/react/public/config/default.js).
+When we build, the `%REACT_APP_CONFIG%` value in
+our[`/public/index.html`](https://github.com/OHIF/Viewers/blob/react/public/index.html#L12-L15)`file is substituted for the correct configuration file's name. Ultimately setting the`window.config`
+equal to our configuration file's value.
+
+- Modify its values directly
+- Create a new config file, and set the `REACT_APP_CONFIG` environement variable
+-
+
+The build process knows which file to use based on the `REACT_APP_CONFIG`
+environment variable. You can set the value of this environment variable a few
+different ways:
+
+- [Add a temporary environment variable in your shell](https://facebook.github.io/create-react-app/docs/adding-custom-environment-variables#adding-temporary-environment-variables-in-your-shell)
+- [Add environment specific variables in `.env` file(s)](https://facebook.github.io/create-react-app/docs/adding-custom-environment-variables#adding-development-environment-variables-in-env)
+-
+
+* env vars
+* `REACT_APP_*`
+* config file(s)
 
 ## Next Steps