Merge pull request #4 from temporalio/tw-revise-readme

Revised README.md

README.md

@@ -1,24 +1,34 @@
-# OMS Web Interface
+# OMS Web Application
 
-This repository contains the web application corresponding to the Order Management System reference 
-application, code for which is found in the [reference-app-orders-go](https://github.com/temporalio/reference-app-orders-go)
-repository. To run this application, you will need code from both repositories. 
+This repository contains a web application that enables one to interact with the Order 
+Management System (OMS) reference application. Code for the OMS is maintained in the 
+[reference-app-orders-go](https://github.com/temporalio/reference-app-orders-go)
+repository. Since this web application depends on services provided by the OMS, you will 
+need code from both repositories to run it. 
 
-## Running locally
+The steps below minimally cover how to run and build the web application. See the 
+[other repository](https://github.com/temporalio/reference-app-orders-go) 
+for detailed instructions on running and using the Order Management System. 
+
+
+## Running the Web Application Locally
+
+After you start the API servers and one or more Workers, as [described in the 
+OMS instructions](https://github.com/temporalio/reference-app-orders-go?tab=readme-ov-file#quickstart), 
+run the following [`pnpm`](https://pnpm.io/) commands from the root directory of this project:
 
 ```bash
 pnpm i
 pnpm dev
 ```
 
-Navigate to http://127.0.0.1:5173/ to view UI.
+This starts a local server. You can navigate to http://127.0.0.1:5173/ to view the web application. 
 
-## Building
 
-To create a production version of your app:
+## Building the Web Application
 
-```bash
-pnpm build
-```
+Run `pnpm build` to create a production version of your app. You can then preview the production build by
+running `pnpm preview`.
 
-You can preview the production build with `pnpm preview`.
+The [`.github/workflows/docker-publish.yml`](https://github.com/temporalio/reference-app-orders-web/blob/main/.github/workflows/docker-publish.yml) 
+file automates the creation and publication of Docker images in response to code changes.