Skip to content

Commit 8c28b0c

Browse files
richlanderclaude
andcommitted
Align reference.md with llms.txt updates
- Entry Points table: "Version/patch" → "Single-version", "Time-based" → "Time-range" - Month Index schema: added prev-security link to show year-boundary crossing - Added traversal example for "CVEs since September 2024" - Added expected fetch counts for self-assessment 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent ab87c6f commit 8c28b0c

File tree

1 file changed

+24
-2
lines changed

1 file changed

+24
-2
lines changed

llms/reference.md

Lines changed: 24 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,8 @@ For quick reference, see [llms.txt](https://raw.githubusercontent.com/dotnet/cor
88

99
| Query Type | Entry Point |
1010
|------------|-------------|
11-
| Version/patch queries | `https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/index.json` |
12-
| Time-based queries | `https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/index.json` |
11+
| Single-version queries | `https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/index.json` |
12+
| Time-range queries | `https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/index.json` |
1313

1414
**CRITICAL**: Never construct URLs manually. Always follow `_links["..."].href` values from JSON responses.
1515

@@ -256,6 +256,7 @@ Link relation names are self-documenting:
256256
"_links": {
257257
"self": { "href": ".../timeline/2025/01/index.json" },
258258
"prev": { "href": ".../timeline/2024/12/index.json" },
259+
"prev-security": { "href": ".../timeline/2024/11/index.json" },
259260
"cve-json": { "href": ".../timeline/2025/01/cve.json" }
260261
},
261262
"_embedded": {
@@ -501,6 +502,27 @@ The `prev-security` links are pre-computed at publish time and cross year bounda
501502

502503
**Anti-pattern:** Do not fetch year indexes to inspect `_embedded.months[]` and plan fetches manually (this adds fetches and duplicates work the graph already did). The `prev-security` chain already encodes this — follow it instead.
503504

505+
Example traversal for "CVEs since September 2024":
506+
507+
```text
508+
Timeline Index → 2025/index.json
509+
→ latest-security-month → 2025/10 ✓
510+
→ prev-security → 2025/06 ✓
511+
→ prev-security → 2025/04 ✓
512+
→ prev-security → 2025/01 ✓
513+
→ prev-security → 2024/11 ✓ (crosses year boundary)
514+
→ prev-security → 2024/10 ✓
515+
→ prev-security → 2024/08 (before Sept, STOP)
516+
```
517+
518+
**Expected fetch counts** (for self-assessment):
519+
520+
* "Latest patch for .NET X": 2–3 fetches
521+
* "CVEs since [date]": 1 + number of security months in range
522+
* "CVEs for specific patch": 2–3 fetches
523+
524+
If your count significantly exceeds these, you may be navigating inefficiently.
525+
504526
**For specific month queries**, navigate directly:
505527

506528
1. GET `timeline/index.json` → navigate to year → navigate to month

0 commit comments

Comments
 (0)