docs: update sql review tut (#516)

* docs: update sql-review tut

* update

* update

Author: OP3ratordec

content/docs/share/tutorials/create-service-account.md

@@ -1,5 +1,5 @@
-1.  Log in as the admin user, and go to **Security & Policy > Users & Groups**. Click **+ Add User**, fill in with `api-example`, choose the `DBA` role that is sufficient for this tutorial and click **Confirm**.
+1.  Log in as 'Workspace Admin', and go to **IAM & Admin** > **Users & Groups**. Click **+ Add User**, fill in with `api-sample`, choose the `Workspace DBA` role sufficient for this tutorial and click **Confirm**.
     ![service-account-create](/content/docs/tutorials/share/add-service-account.webp)
 
-1.  Find the newly created service account and click on **Copy Service Key**. We will use this token to authenticate the API calls.
+1.  Find the newly created service account and **Copy Service Key**. We will use this token to authenticate the API calls.
     ![service-account-key](/content/docs/tutorials/share/service-account-key.webp)

content/docs/tutorials/api-sql-review.md

@@ -15,7 +15,7 @@ This tutorial will guide you through configuring SQL review rules using the Byte
 
 <HintBlock type="info">
 
-This tutorial code repository is at https://github.com/bytebase/api-example/tree/main/sql-review
+[Tutorial Code Repository](https://github.com/bytebase/api-example/tree/main/sql-review)
 
 </HintBlock>
 
@@ -34,15 +34,16 @@ This tutorial code repository is at https://github.com/bytebase/api-example/tree
 
 ## Obtain the Access Token
 
-1. Go to [Bytebase API Example
-   repo](https://github.com/bytebase/api-example) and clone it.
+1. Go to [Bytebase API Example repo](https://github.com/bytebase/api-example) and clone it.
 
-1. Go to subfolder `sql-review`, and follow the instructions in the `README.md` to run the scripts. replace the `bytebase_url`, `bytebase_account`, `bytebase_password` with your own values. Then you will get a `bytebase_token` looks like `ey....9V8s`.
+1. Navigate to the `sql-review` subfolder and follow the instructions in the `README.md` file of the example code repository to execute the scripts.
+   
+1. Replace `bytebase_url`, `bytebase_account`, and `bytebase_password` in the commands below with your own values, then run them to obtain a `bytebase_token` in your terminal.
 
    ```bash
    export bytebase_url=http://localhost:8080
    export bytebase_account=api-sample@service.bytebase.com
-   export bytebase_password=bbs_xxxxxxxxxxxxxilcLVG
+   export bytebase_password=bbs_************ilcLVG
    bytebase_token=$(curl -v ${bytebase_url}/v1/auth/login \
       --data-raw '{"email":"'${bytebase_account}'","password":"'${bytebase_password}'","web":true}' \
       --compressed 2>&1 | grep token | grep -o 'access-token=[^;]*;' | grep -o '[^;]*' | sed 's/access-token=//g; s/;//g')
@@ -53,21 +54,6 @@ This tutorial code repository is at https://github.com/bytebase/api-example/tree
 
 1. Continue following the `README.md` to run the scripts.
 
-   ```bash
-   curl --request PATCH ${bytebase_url}/v1/reviewConfigs/basic \
-      --header 'Authorization: Bearer '${bytebase_token} \
-      --data @policy/basic.json
-
-   curl --request PATCH ${bytebase_url}/v1/reviewConfigs/advanced \
-      --header 'Authorization: Bearer '${bytebase_token} \
-      --data @policy/advanced.json
-   ```
-
-1. In the Bytebase console, navigate to **CI/CD > SQL Review** to see the applied SQL review rules. You may click **Edit** to change the rules.
-   ![bb-sql-review-config](/content/docs/tutorials/api-sql-review/bb-sql-review-config.webp)
-
-1. To delete the SQL review rules, use the following commands:
-
    ```bash
    curl --request PATCH "${bytebase_url}/v1/reviewConfigs/basic?allow_missing=true&update_mask=rules" \
       --header 'Authorization: Bearer '${bytebase_token} \
@@ -78,11 +64,14 @@ This tutorial code repository is at https://github.com/bytebase/api-example/tree
       --data @policy/advanced.json
    ```
 
+1. In the Bytebase console, navigate to **CI/CD > SQL Review** to see the applied SQL review rules. You may click **Edit** to change the rules.
+   ![sql-review-config](/content/docs/tutorials/api-sql-review/sql-review-config.webp)
+
 ## Attach SQL Review Policies to Resources
 
-You may notice that the SQL review rules are not applied to any resources yet from the above screenshot. In Bytebase, the SQL review rules can be applied to the `environments` or `projects`. Project-level rules take precedence over environment-level rules.
+We'll apply these SQL review rules to `environments` or `projects`. Project-level rules take precedence over environment-level rules.
 
-1. Follow the `README.md` to run the scripts to apply the SQL review rules to environments.
+1. Run these command in 'README.md' of the repo to apply the SQL review rules to environments.
 
    ```bash
    curl --request PATCH "${bytebase_url}/v1/environments/test/policies/tag?allow_missing=true&update_mask=payload" \
@@ -103,15 +92,15 @@ You may notice that the SQL review rules are not applied to any resources yet fr
    ```
 
 1. On the **CI/CD > SQL Review** page, you will see the SQL review rules are applied to environments and projects.
-   ![bb-sql-review-config-rsc](/content/docs/tutorials/api-sql-review/bb-sql-review-config-rsc.webp)
+   ![sql-review-config-apply](/content/docs/tutorials/api-sql-review/sql-review-config-apply.webp)
 
 1. Go to **Environments** page, click **Test** environment to see the applied SQL review rules.
-   ![bb-env](/content/docs/tutorials/api-sql-review/bb-env.webp)
+   ![sql-review-env](/content/docs/tutorials/api-sql-review/sql-review-env.webp)
 
 1. Go to `Sample Project` page, click **Setting** on the left sidebar to see the applied the SQL review rules.
    ![bb-project-setting](/content/docs/tutorials/api-sql-review/bb-project-setting.webp)
 
-1. To detach SQL review policies from environments and projects, use the following commands:
+1. To detach SQL review policies from environments, use the following commands:
 
    ```bash
    curl --request DELETE ${bytebase_url}/v1/environments/test/policies/tag \
@@ -121,11 +110,23 @@ You may notice that the SQL review rules are not applied to any resources yet fr
       --header 'Authorization: Bearer '${bytebase_token}
    ```
 
+   Similarly as to detach from projects:
+
    ```bash
    curl --request DELETE ${bytebase_url}/v1/projects/project-sample/policies/tag \
       --header 'Authorization: Bearer '${bytebase_token}
    ```
 
+1. To delete the SQL review rules, use the following commands:
+
+   ```bash
+   curl --request DELETE ${bytebase_url}/v1/reviewConfigs/basic \
+      --header 'Authorization: Bearer '${bytebase_token}
+
+   curl --request DELETE ${bytebase_url}/v1/reviewConfigs/advanced \
+      --header 'Authorization: Bearer '${bytebase_token}
+   ```
+
 ## Summary
 
 Congratulations! You can now codify SQL review rules using the Bytebase API, in addition to the Bytebase GUI, making SQL review policy as code a reality.