Updated README

Author: nicholasconnelly

README.md

@@ -31,17 +31,54 @@ And workflow for this project looks like
 
 
 
-## Create accounts
+## Create and configure accounts
 
-Create a free Okta Developer Edition account. In the Okta dashboard, create an API Services application using a public/private key pair generated by Okta. Enable `okta.groups.manage` scope and add `Organization Administrator` as an admin role.
+Create a free Okta Developer Edition account. In the Okta Admin Console, create an API Services application using a public/private key pair generated by Okta. Enable `okta.groups.manage` scope and add `Organization Administrator` as an admin role.
 
-In the AWS account, set up an S3 bucket, a DynamoDB Table, and use Secrets Manager for the private key.
+In the AWS account, set up an S3 bucket and a DynamoDB Table for the Terraform backend, and use Secrets Manager for the API Services application private key. Setup the OIDC Identity Provider for GitHub, and the Role and Policy within AWS IAM to allow authentication and authorization to the configured AWS Resources.
 
-In the GitHub account, create a new repository using this project as the template.
+In the GitHub account, create or use an existing GitHub Organization, and create a new repository using this project as the template. Set the `AWS_ROLE_ARN` and `AWS_REGION` repository variables with the respective values from AWS.
 
-## Configure variables
+## Build the CI/CD pipeline using Terraform and Okta
+
+### Setup branches
+
+Create and checkout the develop branch.
+
+```
+git checkout main
+git pull origin main
+git checkout -b develop
+```
+
+### Configure variables
+
+Update the `backend-*.conf` and `tfvars` files and replace variables with values from your Okta account, AWS account, and GitHub.
+
+### Configure resources and variables
+
+Uncomment the pre-defined resources and variables within the `terraform/modules/directory/variables.tf`, `terraform/modules/directory/okta_groups.tf`, `terraform/variables.tf`, `terraform/main.tf`, and `tfvars` files to prepare for creating a group within the Okta environments.
+
+### Push the changes to develop
+
+Stage and push the changes to the develop branch to trigger the GitHub Actions workflow `Dev Build`, which uses Terraform to build against the Okta development environment.
+
+```
+git add .
+git commit -m "Initial commit"
+git push origin develop
+```
+
+Observe the workflow within GitHub Actions.
+
+### Pull request to main
+
+Create a pull request from develop to main within the repository to trigger the GitHub Actions workflow `Prod Plan`, which uses Terraform to show the potential changes without applying them against the Okta production environment. Observe the workflow within GitHub Actions.
+
+### Merge to main
+
+Merge the pull request to main within the repository to trigger the GitHub Actions workflow `Prod Build`, which uses Terraform to build against the Okta production environment. Observe the workflow within GitHub Actions.
 
-Update the `backend-*.conf` and `tfvars` files and replace variables with values from your Okta domain, AWS account, and GitHub.
 
 ## Links