Update README with detailed instructions

Author: forrestbao

README.md

@@ -12,21 +12,23 @@ The docker compose files are in `compose/` folder. There are two stacks:
 - The `prod` stack builds the images instead of mounting `src` folders, for the
   purpose of testing image builds.
 
-## Prerequisite
+To install docker-compose, follow [this official instruction](https://docs.docker.com/compose/install/linux/). 
 
-Make sure you have the runtime containers images pulled.
+
+## Pull the docker images 
 
 - TODO automatically pull the images?
 - TODO use a more generic image tag here, e.g. latest
 
 ```
+
 docker pull lihebi/codepod-kernel-python
 docker pull lihebi/codepod-runtime
 ```
 
-## Usage
+## Configuration and starting the services
 
-First, create a `dev/.env` file with the following content (change the value to
+First, create a `dev/.env` file with the following content (leave as is or change the value to
 whatever you want):
 
 ```
@@ -36,11 +38,10 @@ POSTGRES_DB=mydbname
 JWT_SECRET=mysupersecretjwttoken
 ```
 
-Then, modify the nginx.conf and change the `server_name` field to your choices.
+Then, modify the `nginx.conf` and change the `server_name` field to your choices.
 For example, if you are running on localhost, you can use:
 
 ```
-server_name web.127.0.0.1.sslip.io;
 server_name prisma.127.0.0.1.sslip.io;
 ```
 
@@ -52,15 +53,21 @@ docker compose up -d
 ```
 
 If this is your first time running it, the database is empty, and you need to
-initialize the database. To do that, shell into the API container and run
+initialize the database. To do that, shell into the API container 
+
+```shell
+docker exec -it dev-api-1 bash
+```
+
+and run
 
 ```
 npx prisma migrate dev --name init
 ```
 
 Wait a few minutes for packages installation and compilation. Once `ui` and
 `api` containers are ready listening on http ports, go to the DNS name you set
-above, e.g. `http://web.127.0.0.1.sslip.io`, and you should see the web app UI.
+above, e.g. `http://codepod.127.0.0.1.sslip.io`, and you should see the web app UI.
 Additional tools:
 
 - `http://web.127.0.0.1.sslip.io/graphql`: Apollo GraphQL explorer for the backend APIs