Apply suggestions from code review

dannykopping · johnstcn · web-flow · commit 5fa2b96bc12f · 2024-09-10T13:05:03.000+02:00
Co-authored-by: Cian Johnston &lt;cian@coder.com&gt;
diff --git a/coderd/rbac/README.md b/coderd/rbac/README.md
@@ -49,7 +49,7 @@ This can be represented by the following truth table, where Y represents _positi
 - `object` is any valid resource type.
 - `id` is any valid UUID v4.
 - `id` is included in the permission syntax, however only scopes may use `id` to specify a specific object.
-- `action` is `create`, `read`, `modify`, `delete`, or another verb.
+- `action` is typically `create`, `read`, `modify`, `delete`, but you can define other verbs as needed.
 
 ## Example Permissions
 
diff --git a/coderd/rbac/USAGE.md b/coderd/rbac/USAGE.md
@@ -103,7 +103,7 @@ Let's now add our frobulator noun to `coderd/rbac/policy/policy.go`:
     ...
 ```
 
-Entries in the `frobulators` table be created/read/updated/deleted, so we define
+We need to create/read/update/delete rows in the `frobulators` table, so we define
 those actions.
 
 `policy.go` is used to generate code in `coderd/rbac/object_gen.go`, and we can
@@ -288,7 +288,7 @@ FAIL
 This shows you that the `org_auditor` role has `read` permissions on the
 frobulator, but no test case covered it.
 
-**NOTE: don't just add cases which make the tests pass; consider all the way in
+**NOTE: don't just add cases which make the tests pass; consider all the ways in
 which your resource must be used, and test all of those scenarios!**
 
 # Database authorization
