Skip to content

Commit ae92b56

Browse files
authored
[workflow-editor] docs-linker: remove redundant static URL table (#1344)
1 parent 2aa9f0f commit ae92b56

2 files changed

Lines changed: 6 additions & 42 deletions

File tree

.github/workflows/docs-linker.lock.yml

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

.github/workflows/docs-linker.md

Lines changed: 5 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -211,44 +211,8 @@ conventions:
211211
https://github.github.com/gh-aw/<category>/<page-slug>/
212212
```
213213

214-
Use the table below as your authoritative map of source reference files to
215-
rendered doc URLs. When the agent discovers additional pages while fetching
216-
docs, add them to its working knowledge.
217-
218-
| Source file in github/gh-aw | Rendered URL |
219-
|---|---|
220-
| `.github/aw/github-agentic-workflows.md` | `https://github.github.com/gh-aw/introduction/overview/` |
221-
| `.github/aw/syntax-core.md` | `https://github.github.com/gh-aw/reference/syntax/` |
222-
| `.github/aw/syntax-agentic.md` | `https://github.github.com/gh-aw/reference/agentic/` |
223-
| `.github/aw/syntax-tools-imports.md` | `https://github.github.com/gh-aw/reference/tools/` |
224-
| `.github/aw/triggers.md` | `https://github.github.com/gh-aw/reference/triggers/` |
225-
| `.github/aw/memory.md` | `https://github.github.com/gh-aw/reference/memory/` |
226-
| `.github/aw/safe-outputs.md` | `https://github.github.com/gh-aw/reference/safe-outputs/` |
227-
| `.github/aw/safe-outputs-content.md` | `https://github.github.com/gh-aw/reference/safe-outputs-content/` |
228-
| `.github/aw/safe-outputs-automation.md` | `https://github.github.com/gh-aw/reference/safe-outputs-automation/` |
229-
| `.github/aw/safe-outputs-management.md` | `https://github.github.com/gh-aw/reference/safe-outputs-management/` |
230-
| `.github/aw/safe-outputs-runtime.md` | `https://github.github.com/gh-aw/reference/safe-outputs-runtime/` |
231-
| `.github/aw/network.md` | `https://github.github.com/gh-aw/reference/network/` |
232-
| `.github/aw/messages.md` | `https://github.github.com/gh-aw/reference/messages/` |
233-
| `.github/aw/subagents.md` | `https://github.github.com/gh-aw/reference/subagents/` |
234-
| `.github/aw/loop.md` | `https://github.github.com/gh-aw/reference/loop/` |
235-
| `.github/aw/patterns.md` | `https://github.github.com/gh-aw/guides/patterns/` |
236-
| `.github/aw/workflow-patterns.md` | `https://github.github.com/gh-aw/guides/workflow-patterns/` |
237-
| `.github/aw/token-optimization.md` | `https://github.github.com/gh-aw/guides/token-optimization/` |
238-
| `.github/aw/context.md` | `https://github.github.com/gh-aw/reference/context/` |
239-
| `.github/aw/skills.md` | `https://github.github.com/gh-aw/reference/skills/` |
240-
| `.github/aw/reuse.md` | `https://github.github.com/gh-aw/guides/reuse/` |
241-
| `.github/aw/experiments.md` | `https://github.github.com/gh-aw/reference/experiments/` |
242-
| `.github/aw/github-mcp-server.md` | `https://github.github.com/gh-aw/reference/github-mcp-server/` |
243-
| `.github/aw/mcp-clis.md` | `https://github.github.com/gh-aw/reference/mcp-clis/` |
244-
| `.github/aw/agentic-workflows-mcp.md` | `https://github.github.com/gh-aw/reference/agentic-workflows-mcp/` |
245-
| `.github/aw/cli-commands.md` | `https://github.github.com/gh-aw/reference/cli-commands/` |
246-
| `.github/aw/pr-reviewer.md` | `https://github.github.com/gh-aw/guides/pr-reviewer/` |
247-
| `.github/aw/report.md` | `https://github.github.com/gh-aw/guides/report/` |
248-
| `.github/aw/llms.md` | `https://github.github.com/gh-aw/reference/llms/` |
249-
| `.github/aw/workflow-constraints.md` | `https://github.github.com/gh-aw/reference/workflow-constraints/` |
250-
| `.github/aw/workflow-editing.md` | `https://github.github.com/gh-aw/guides/workflow-editing/` |
251-
| `github.blog/tag/github-for-beginners/` | `https://github.blog/tag/github-for-beginners/` |
214+
Use the prebuilt doc index at `/tmp/gh-aw/data/doc-index.json` as the
215+
authoritative source of rendered doc page URLs and section anchors.
252216

253217
---
254218

@@ -308,7 +272,7 @@ docs, add them to its working knowledge.
308272
## Identify Concepts and Tasks
309273

310274
For each file in `target_files`, scan the file for every **concept**, **task**,
311-
**term**, or **feature** that has a matching reference page in the docs-site table
275+
**term**, or **feature** that has a matching reference page in the doc index
312276
above. Consider:
313277

314278
- Frontmatter fields mentioned (`on:`, `permissions:`, `tools:`, `safe-outputs:`,
@@ -322,7 +286,7 @@ above. Consider:
322286
For each matched concept, resolve the most precise URL using the doc index loaded
323287
in the previous step:
324288

325-
1. Look up the page URL for the concept in the docs-site table.
289+
1. Look up the page URL for the concept in the doc index.
326290
2. If the doc index has anchors for that page, find the anchor whose `text` most
327291
closely matches the concept term (case-insensitive, partial match allowed).
328292
3. If a matching anchor is found, use its `url` field (which includes `#anchor-id`)
@@ -349,7 +313,7 @@ Build a mapping:
349313
]
350314
```
351315

352-
Only include entries where a matching URL exists in the table.
316+
Only include entries where a matching URL exists in the doc index.
353317

354318
---
355319

0 commit comments

Comments
 (0)