chore: simplify doc and add x-envs section

Author: schitizsharma

docs/install/olake-ui/index.mdx

@@ -134,11 +134,9 @@ This will create and use `/custom/path/to/olake-data` instead of the default `./
 
 ### External PostgreSQL Configuration
 
-OLake supports using an **external PostgreSQL instance** instead of the built-in Postgres service included in the docker-compose file. PostgreSQL stores all job data, configurations, sync state, and Temporal workflow data.
+OLake supports using an **external PostgreSQL instance** instead of the built-in Postgres service included in the docker-compose file. This PostgreSQL stores all job data, configurations, sync state, and Temporal workflow data.
 
-**Configure `docker-compose.yml`**
-
-Within the compose file, an extension field named `x-db-envs` defines all database configuration values used by OLake and Temporal. These values can be modified to point to the external PostgreSQL instance.
+Within the [compose file](https://raw.githubusercontent.com/datazip-inc/olake-ui/master/docker-compose.yml), an extension field named `x-db-envs` defines all database configuration values used by OLake and Temporal. These values can be modified to point to the external PostgreSQL instance.
 
 ```yaml
 x-db-envs:
@@ -151,33 +149,34 @@ x-db-envs:
   TEMPORAL_DB_NAME: &temporalDBName temporal
 ```
 
-The compose file includes optional TLS-related variables for Temporal's SQL connection. 
-When Temporal is configured to use an external PostgreSQL instance particularly one with SSL/TLS enabled, these variables can be uncommented and configured as needed.
+If connection to external PostgreSQL instance is over TLS, the following variables need to be uncommented under `services.temporal.env` section in the compose file:
 
 ```yaml
-  # for external postgres database
+  # for TLS enabled external postgres database
   SQL_TLS: true
   SQL_TLS_DISABLE_HOST_VERIFICATION: true
   SQL_TLS_ENABLED: true
   SQL_HOST_VERIFICATION: false
 ```
 
-:::info **Note** (optional)
+:::info **Optional**
 A separate PostgreSQL container (`postgresql` service) is included by default.
-When an external database is used, this service is not needed and can be removed after all the services are started and healthy.
+When an external database is used, this service is not needed and can be stopped after all the services are started and healthy.
 :::
 
 ### Service Environment Variables
 
-Key environment variables that can be customized within specific services:
+Key environment variables that can be customized within `x-envs` section. These variables are automatically injected into the `olake-ui` and `olake-worker` containers:
 
 ```yaml
-services:
-  olake-ui:
-    environment:
-      PERSISTENT_DIR: *hostPersistencePath
-      POSTGRES_DB: "postgres://olake:olake@postgresql:5432/olakedb"
-      OLAKE_SECRET_KEY: *encryptionKey
+x-envs:
+  shared: &sharedEnvs
+    CONTAINER_REGISTRY_BASE: ${CONTAINER_REGISTRY_BASE:-registry-1.docker.io}
+    OLAKE_SECRET_KEY: *encryptionKey
+    PERSISTENT_DIR: *hostPersistencePath
+    FOO: bar
+    KEY: value
+    NAME: example
 ```
 
 ### Data Persistence