fix: update README examples to show file paths instead of JSON content

Agent-Logs-Url: https://github.com/github/accessibility-scanner/sessions/b0cb0e0c-0e54-4d95-94ff-e51a544599c0

Co-authored-by: lindseywild <35239154+lindseywild@users.noreply.github.com>

Author: Copilot

.github/actions/file/README.md

@@ -8,10 +8,11 @@ Files GitHub issues to track potential accessibility gaps.
 
 #### `findings_file`
 
-**Required** Path to a JSON file containing the list of potential accessibility gaps. For example:
+**Required** Path to a JSON file containing the list of potential accessibility gaps. For example: `findings.json`.
 
-```JS
-'[]'
+The file should contain a JSON array of finding objects. For example:
+```json
+[]
 ```
 
 #### `repository`
@@ -24,10 +25,30 @@ Files GitHub issues to track potential accessibility gaps.
 
 #### `cached_filings_file`
 
-**Optional** Path to a JSON file containing cached filings from previous runs. Without this, duplicate issues may be filed. For example: `'[{"findings":[],"issue":{"id":1,"nodeId":"SXNzdWU6MQ==","url":"https://github.com/github/docs/issues/123","title":"Accessibility issue: 1"}}]'`
+**Optional** Path to a JSON file containing cached filings from previous runs. Without this, duplicate issues may be filed. For example: `cached-filings.json`.
+
+The file should contain a JSON array of filing objects. For example:
+```json
+[
+  {
+    "findings": [],
+    "issue": {"id":1,"nodeId":"SXNzdWU6MQ==","url":"https://github.com/github/docs/issues/123","title":"Accessibility issue: 1"}
+  }
+]
+```
 
 ### Outputs
 
 #### `filings_file`
 
-Path to a JSON file containing the list of issues filed (and their associated finding(s)). For example: `'[{"findings":[],"issue":{"id":1,"nodeId":"SXNzdWU6MQ==","url":"https://github.com/github/docs/issues/123","title":"Accessibility issue: 1"}}]'`
+Path to a JSON file containing the list of issues filed (and their associated finding(s)). For example: `filings.json`.
+
+The file will contain a JSON array of filing objects. For example:
+```json
+[
+  {
+    "findings": [],
+    "issue": {"id":1,"nodeId":"SXNzdWU6MQ==","url":"https://github.com/github/docs/issues/123","title":"Accessibility issue: 1"}
+  }
+]
+```

.github/actions/find/README.md

@@ -43,8 +43,9 @@ configuration option.
 
 #### `findings_file`
 
-List of potential accessibility gaps, output as a JSON file. For example:
+Path to a JSON file containing the list of potential accessibility gaps. For example: `findings.json`.
 
-```JS
-'[]'
+The file will contain a JSON array of finding objects. For example:
+```json
+[]
 ```

.github/actions/fix/README.md

@@ -8,7 +8,16 @@ Attempts to fix issues with Copilot.
 
 #### `issues_file`
 
-**Required** Path to a JSON file containing the list of issues to attempt to fix—including, at a minimum, their `url`s. For example: `'[{"url":"https://github.com/github/docs/issues/123"},{"nodeId":"SXNzdWU6Mg==","url":"https://github.com/github/docs/issues/124"},{"id":4,"nodeId":"SXNzdWU6NA==","url":"https://github.com/github/docs/issues/126","title":"Accessibility issue: 4"}]'`.
+**Required** Path to a JSON file containing the list of issues to attempt to fix—including, at a minimum, their `url`s. For example: `issues.json`.
+
+The file should contain a JSON array of issue objects. For example:
+```json
+[
+  {"url":"https://github.com/github/docs/issues/123"},
+  {"nodeId":"SXNzdWU6Mg==","url":"https://github.com/github/docs/issues/124"},
+  {"id":4,"nodeId":"SXNzdWU6NA==","url":"https://github.com/github/docs/issues/126","title":"Accessibility issue: 4"}
+]
+```
 
 #### `repository`
 
@@ -22,4 +31,14 @@ Attempts to fix issues with Copilot.
 
 #### `fixings_file`
 
-Path to a JSON file containing the list of pull requests filed (and their associated issues). For example: `'[{"issue":{"id":1,"nodeId":"SXNzdWU6MQ==","url":"https://github.com/github/docs/issues/123","title":"Accessibility issue: 1"},"pullRequest":{"url":"https://github.com/github/docs/pulls/124"}}]'`
+Path to a JSON file containing the list of pull requests filed (and their associated issues). For example: `fixings.json`.
+
+The file will contain a JSON array of fixing objects. For example:
+```json
+[
+  {
+    "issue": {"id":1,"nodeId":"SXNzdWU6MQ==","url":"https://github.com/github/docs/issues/123","title":"Accessibility issue: 1"},
+    "pullRequest": {"url":"https://github.com/github/docs/pulls/124"}
+  }
+]
+```