readme update

Author: jgbradley1

infra/README.md

@@ -28,25 +28,25 @@ az bicep build --file main.bicep --outfile managed-app/mainTemplate.json
 
 Use the [Azure Portal Sandbox](https://portal.azure.com/#blade/Microsoft_Azure_CreateUIDef/SandboxBlade) to test and make any UI changes that are defined in [createUiDefinition.json](createUiDefinition.json). To make additional changes to the Azure portal experience, start by reading some [documentation](https://learn.microsoft.com/en-us/azure/azure-resource-manager/managed-applications/create-uidefinition-overview) and copying the contents of `createUiDefinition.json` into the sandbox environment.
 
-### 4. Create the deployment package
+### 4. Prepare the deployment package
 
 A *deployment package* is a zip file comprised of several files. This includes the json files from the previous steps along with any additional code relevant to the deployment (i.e. artifacts)
 
 Note that the file names for the json files (`mainTemplate.json` and `createUiDefinition.json`) should not be modified and are case-sensitive. Azure expects these files as part of a managed app deployment package.
 
-A local copy of the backend docker image is needed in order to retrieve a copy of the openapi.json spec associated with GraphRAG's REST API. This api spec file will become part of the final deployment package.
+A local copy of the backend docker image needs to be built in order to retrieve a copy of the openapi.json spec associated with GraphRAG's REST API. This api spec file will become part of the final deployment package.
 ```shell
 cd <repo_root_directory>
 docker build -t graphrag:backend -f docker/Dockerfile-backend .
-docker run -it -p 8080:80 graphrag:backend
+docker run -d -p 8080:80 graphrag:backend
 ```
 
 Now create the deployment package:
 ```bash
 cd <repo_root_directory>/infra
 
 # get the openapi specification file
-curl -s -o managed-app/openapi.json http://localhost:8080/manpage/openapi.json
+curl --fail-with-body -o managed-app/openapi.json http://localhost:8080/manpage/openapi.json
 
 # add graphrag helm chart as an additional artifact
 cp -r helm/graphrag managed-app/artifacts/
@@ -56,7 +56,7 @@ cd managed-app
 tar -a -cf managed-app-deployment-pkg.zip createUiDefinition.json mainTemplate.json openapi.json artifacts
 ```
 
-The deployment package will have the following file structure:
+The deployment package should have the following file structure:
 ```bash
 managed-app-deployment-pkg.zip
 ├── artifacts
@@ -72,9 +72,9 @@ managed-app-deployment-pkg.zip
 └── openapi.json
 ```
 
-This zip file should be uploaded to an Azure Storage location in preparation for the next step, setting up a Service Catalog Managed Application Definition.
+This zip file should be uploaded to an Azure Storage location in preparation for the next step.
 
-### 5. Create the Service Catalog Managed App Definition
+### 5. Create a Service Catalog Managed App Definition
 
 Click [here](https://ms.portal.azure.com/#view/Microsoft_Azure_Marketplace/GalleryItemDetailsBladeNopdl/id/Microsoft.ApplianceDefinition/selectionMode~/false/resourceGroupId//resourceGroupLocation//dontDiscardJourney~/false/selectedMenuId/home/launchingContext~/%7B%22galleryItemId%22%3A%22Microsoft.ApplianceDefinition%22%2C%22source%22%3A%5B%22GalleryFeaturedMenuItemPart%22%2C%22VirtualizedTileDetails%22%5D%2C%22menuItemId%22%3A%22home%22%2C%22subMenuItemId%22%3A%22Search%20results%22%2C%22telemetryId%22%3A%2220409084-39a1-4800-bbce-d0b26a6f46a4%22%7D/searchTelemetryId/d7d20e05-ca16-47f7-bed5-9c7b8d2fa641) or from within the Azure Portal, go to Marketplace and create a `Service Catalog Managed App Definition`. You will be asked to provide a uri link to the uploaded `managed-app-deployment-pkg.zip` file during the creation process.