doc: add wildcard documentation

README.md

@@ -28,26 +28,34 @@ Manage access from GitHub actions workflows by providing temporary app access to
 * Create `.github/access.yaml` file
 * Set `self` to enclosing repository. 
   * This ensures no unintended access in case you fork a repository with `.github/access.yaml` file.  
-* Add policies and [permissions](https://docs.github.com/en/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token), see examples below.
+* Add `policies` and [permissions](https://docs.github.com/en/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token), see examples below.
+  * `repository` value supports wildcards `*` e.g. `repository: octa-org/*`
   * ⚠ `metadata: read` permission is implicitly always granted.
 ##### Example configurations
-* Grant read access to GitHub Packages
-  ```yaml
-  self: example/test
-  policies:
-  - repository: example/sandbox
-    permissions:
-      packages: read
-  ```
 * Self access to trigger workflows from another workflow
   ```yaml
-  self: example/test
+  self: qoomon/example
   policies:
   - repository: self
     permissions:
       actions: write
   ```
-
+* Grant read access to GitHub Packages for an explicit repository
+    ```yaml
+    self: qoomon/example
+    policies:
+    - repository: qoomon/sandbox
+      permissions:
+        packages: read
+    ```
+* Grant read access to GitHub Packages for an entire organization
+    ```yaml
+    self: qoomon/example
+    policies:
+    - repository: octa-org/*
+      permissions:
+        packages: read
+    ```
 ### Setup GitHub Action Workflow
 ```yaml
 on: