Updated readme (#37)

Author: ToreMerkely

README.md

@@ -1,11 +1,16 @@
 # github-release-example
-An example of how an approval for release to a protected environment in GitHub can be
-logged as an attestation in Kosli.
+An example of how an approval in a GitHub workflow can be logged as an attestation in Kosli.
 
 ## How to demo
 
+### Setup
+There is a separate [GitHub workflow](https://github.com/kosli-dev/github-release-example/actions/workflows/setup-kosli.yml)
+to create the [flow](https://app.kosli.com/kosli-public/flows/github-release-example-backend/trails/)
+and the custom attestation [approval-github-workflow](https://app.kosli.com/kosli-public/attestation-types/approval-github-workflow)
+used in this demo.
+
 ### Build a new version of backend
-Make a branch for your change
+Make a branch for your change:
 ```shell
 git checkout -b backent-next-version
 ```
@@ -17,9 +22,11 @@ apps/backend/backend-content.txt
 Commit and push the change to GitHub.
 Create a Pullrequest and merge the change back to main.
 
-This will trigger a workflow in [GitHub](https://github.com/kosli-dev/github-release-example/actions/workflows/build-deploy-backend.yml)
+This will trigger a [Build and deploy](https://github.com/kosli-dev/github-release-example/actions/workflows/build-deploy-backend.yml)
+workflow in GitHub.
 
-You now have to approve the deployment to `staging envirnment`
+The GitHub workflow will stopp after a short period waiting for your approval of deploying
+the SW to Stage. Approve it and the workflow will finish.
 
 You should now have a trail that matches the commit in the 
 [github-release-example-backend](https://app.kosli.com/kosli-public/flows/github-release-example-backend/trails/) flow.
@@ -40,6 +47,6 @@ This will trigger the same workflow in [GitHub](https://github.com/kosli-dev/git
 
 The trail name will match the version tag.
 
-Approve the SW for staging first, and then for production.
+Approve the SW for `Stage` first, and then for `Production`.
 
 In the Kosli trail for the release you will now have a `release-approval` in addition to the pull-request and artifact.