update upgrading.md

docs/upgrading.md

@@ -2,24 +2,29 @@
 
 ## Configuration Changes (Q1 2023)
 
-Please read [configuration.md](./configuration.md) for a complete list of configuration values.
+`polis.config.template.js` and `polis.config.js` files are removed and no longer used.
+`docker-dev.env` and `docker-db-dev.env` files are removed and no longer used.
+`.env` and/or `prod.env` are now treated as the source of truth for the application and are ignored by git.
+See `example.env` for default values.
+
+Please read [configuration.md](./configuration.md) for more information and a complete list of configuration values.
 
 Values that have been renamed or replaced:
 
 - **`DATABASE_FOR_READS_NAME`** has been replaced by **`READ_ONLY_DATABASE_URL`**
 - **`PORT`** has been renamed **`API_SERVER_PORT`**
-- **`STATIC_FILES_ADMINDASH_PORT`** has been renamed to **`STATIC_FILES_ADMIN_PORT`**
 - **`SERVICE_HOSTNAME`** has been renamed to **`EMBED_SERVICE_HOSTNAME`**
+- **`STATIC_FILES_ADMINDASH_PORT`** has been renamed to **`STATIC_FILES_ADMIN_PORT`**
 
 New values:
 
-- **`SERVER_ENV_FILE`**
-- **`SERVER_LOG_LEVEL`**
-- **`POSTGRES_HOST`**
-- **`POSTGRES_PORT`**
-- **`STATIC_FILES_PARTICIPATION_PORT`**
-- **`SERVER_LOG_TO_FILE`**
 - **`API_DEV_HOSTNAME`**
 - **`API_PROD_HOSTNAME`**
 - **`ENABLE_TWITTER_WIDGETS`**
 - **`GA_TRACKING_ID`**
+- **`POSTGRES_HOST`**
+- **`POSTGRES_PORT`**
+- **`SERVER_ENV_FILE`**
+- **`SERVER_LOG_LEVEL`**
+- **`SERVER_LOG_TO_FILE`**
+- **`STATIC_FILES_PARTICIPATION_PORT`**