docs(nebraska): add docker exec option for postgres setup

Author: chengr4

content/docs/latest/updates-releases/nebraska/development.md

@@ -25,21 +25,48 @@ environment variable `NEBRASKA_DB_URL`.
 For a quick setup of `PostgreSQL` for Nebraska's development, you can use
 the `postgres` container as follows:
 
-- Start `Postgres`:
-    - `docker run --rm -d --name nebraska-postgres-dev -p 5432:5432 -e POSTGRES_PASSWORD=nebraska postgres`
+- Start `Postgres` and wait until it is ready to accept connections:
 
-- Create the database for Nebraska (by default it is `nebraska`):
-    - `psql postgres://postgres:nebraska@localhost:5432/postgres -c 'create database nebraska;'`
+  ```bash
+  docker run --rm -d --name nebraska-postgres-dev -p 5432:5432 -e POSTGRES_PASSWORD=nebraska postgres
 
-- Set the timezone to Nebraska's database:
-    - `psql postgres://postgres:nebraska@localhost:5432/nebraska -c 'set timezone = "utc";'`
+  # Wait until Postgres is ready to accept connections (timeout after ~60s)
+  for i in {1..60}; do
+     docker exec nebraska-postgres-dev pg_isready -U postgres >/dev/null 2>&1 && break
+     sleep 1
+  done
+  docker exec nebraska-postgres-dev pg_isready -U postgres >/dev/null 2>&1 || { echo "Postgres did not become ready within 60s"; exit 1; }
+  ```
 
-- Set up the nebraska_tests database for running unit tests
+- Initialize the databases (`nebraska` and `nebraska_tests`) using either of the following methods:
 
-```bash
-psql postgres://postgres:nebraska@localhost:5432/postgres -c 'create database nebraska_tests;'
-psql postgres://postgres:nebraska@localhost:5432/nebraska_tests -c 'set timezone = "utc";'
-```
+  - **Option A: Using local `psql`** (if you have `psql` installed on your host machine):
+
+    ```bash
+    # Create the database for Nebraska (by default it is `nebraska`)
+    psql postgres://postgres:nebraska@localhost:5432/postgres -c 'create database nebraska;'
+
+    # Set the timezone to Nebraska's database
+    psql postgres://postgres:nebraska@localhost:5432/nebraska -c "alter database nebraska set timezone to 'utc';"
+
+    # Set up the nebraska_tests database for running unit tests
+    psql postgres://postgres:nebraska@localhost:5432/postgres -c 'create database nebraska_tests;'
+    psql postgres://postgres:nebraska@localhost:5432/nebraska_tests -c "alter database nebraska_tests set timezone to 'utc';"
+    ```
+
+  - **Option B: Using `docker exec`** (run directly inside the container without requiring local PostgreSQL tools):
+
+    ```bash
+    # Create the database for Nebraska (by default it is `nebraska`)
+    docker exec nebraska-postgres-dev psql -U postgres -c "create database nebraska;"
+
+    # Set the timezone to Nebraska's database
+    docker exec nebraska-postgres-dev psql -U postgres -c "alter database nebraska set timezone to 'utc';"
+
+    # Set up the nebraska_tests database for running unit tests
+    docker exec nebraska-postgres-dev psql -U postgres -c "create database nebraska_tests;"
+    docker exec nebraska-postgres-dev psql -U postgres -c "alter database nebraska_tests set timezone to 'utc';"
+    ```
 
 ## Development Quickstart