docs

Author: erikburt

README.md

@@ -2,6 +2,15 @@
 
 Org-wide Github Actions (GHA) workflows for [smartcontractkit](https://github.com/smartcontractkit).
 
+## Limitations
+
+Org-wide rulesets have limitations.
+
+1. Can only use events: `merge_queue`, `pull_request_target`, `pull_request`.
+2. They will not run automatically if event is triggered by a CI's `GITHUB_TOKEN`
+   * See https://docs.github.com/en/actions/concepts/security/github_token#when-github_token-triggers-workflow-runs
+3. They can interfere with merge queues
+
 ## Workflows
 
 ### Go Mod Validation
@@ -27,6 +36,10 @@ Uses [patrickhuie19/codeowners-validator](https://github.com/patrickhuie19/codeo
 
 Enforces that every repository has a CODEOWNERS file.
 
+### CODEOWNERS Review Analysis
+
+Analyzes modified files, and current reviews to
+
 ## Help
 
 If you are experiencing a blocking error from a workflow in this repository, please reach out to us on `#team-devex`.