Skip to content

Commit 3a45d58

Browse files
richlanderrichlander
committed
Update graph
1 parent bd090fd commit 3a45d58

File tree

166 files changed

+949
-1478
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

166 files changed

+949
-1478
lines changed

‎llms.txt‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,7 @@ Reference:
3030
* Timeline Index → years → months → CVE details
3131
* Properties use `snake_case`; link relations use `kebab-case`
3232
* `latest` and `latest_lts` reference supported (not preview) releases
33+
* **Discover available links**: `jq '._links | keys[]'` on any resource reveals all navigation options
3334

3435
## Do first
3536

‎llms/reference.txt‎

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -76,6 +76,62 @@ The graph provides `.diff` URLs by default in `commits[hash].url`.
7676
5. For migration guidance: check `required_action` field
7777
6. For raw documentation: filter `references[]` by `type: "documentation-source"`
7878

79+
## Discovering Resource Schema
80+
81+
HAL resources are self-describing. If you're unsure what's available, inspect the resource:
82+
83+
```bash
84+
# Quick: list available link relations
85+
jq '._links | keys[]'
86+
87+
# Full: discover properties, links, and embedded resources
88+
jq '{
89+
properties: [to_entries[] | select(.key | startswith("_") | not) | "\(.key) (\(.value | type))"],
90+
links: [._links | keys[]],
91+
embedded: [._embedded | keys[]]
92+
}'
93+
```
94+
95+
Example output for a patch index:
96+
```json
97+
{
98+
"properties": ["kind (string)", "version (string)", "date (string)", "security (boolean)", "cve_count (number)", "cve_records (array)"],
99+
"links": ["cve-json", "prev", "prev-security", "release-major", "release-month", "self"],
100+
"embedded": ["disclosures", "sdk_feature_bands", "sdk_release"]
101+
}
102+
```
103+
104+
### Link Relations by Resource Type
105+
106+
**Root index** (`index.json`):
107+
- `latest`, `latest-lts` — jump to current releases
108+
- `timeline-index` — switch to time-based navigation
109+
- `llms-txt` — LLM quick reference
110+
111+
**Major version** (`10.0/index.json`):
112+
- `latest`, `latest-security` — jump to patches
113+
- `compatibility-json` — breaking changes
114+
- `downloads`, `latest-sdk` — SDK information
115+
- `target-frameworks-json` — TFM data
116+
117+
**Patch release** (`10.0/10.0.1/index.json`):
118+
- `prev`, `prev-security` — backward navigation
119+
- `cve-json`, `cve-markdown` — CVE details
120+
- `release-major`, `release-month` — context navigation
121+
122+
**Manifest** (`10.0/manifest.json`):
123+
- `os-packages-json`, `supported-os-json` — OS dependencies
124+
- `*-rendered` suffixes — GitHub HTML views
125+
126+
### Naming Conventions
127+
128+
Link relation names are self-documenting:
129+
- `-json` suffix → machine-readable data file
130+
- `-markdown` suffix → raw markdown source
131+
- `-rendered` suffix → HTML view on GitHub
132+
- `prev-` prefix → backward navigation
133+
- `latest-` prefix → jump to most recent
134+
79135
## Schema Examples
80136

81137
### Releases Index (`index.json`)

‎release-notes/1.0/index.json‎

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,13 @@
99
"ga_date": "2016-06-27T00:00:00\u002B00:00",
1010
"eol_date": "2019-06-27T00:00:00\u002B00:00",
1111
"_links": {
12+
"self": {
13+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/1.0/index.json"
14+
},
15+
"release-manifest": {
16+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/1.0/manifest.json",
17+
"title": "Release manifest"
18+
},
1219
"releases-index": {
1320
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/index.json",
1421
"title": "Release index"
@@ -31,35 +38,31 @@
3138
"year": "2019",
3239
"_links": {
3340
"self": {
34-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2019/index.json",
35-
"title": ".NET Release Timeline 2019 (chronological)"
41+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2019/index.json"
3642
}
3743
}
3844
},
3945
{
4046
"year": "2018",
4147
"_links": {
4248
"self": {
43-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2018/index.json",
44-
"title": ".NET Release Timeline 2018 (chronological)"
49+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2018/index.json"
4550
}
4651
}
4752
},
4853
{
4954
"year": "2017",
5055
"_links": {
5156
"self": {
52-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2017/index.json",
53-
"title": ".NET Release Timeline 2017 (chronological)"
57+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2017/index.json"
5458
}
5559
}
5660
},
5761
{
5862
"year": "2016",
5963
"_links": {
6064
"self": {
61-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2016/index.json",
62-
"title": ".NET Release Timeline 2016 (chronological)"
65+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2016/index.json"
6366
}
6467
}
6568
}

‎release-notes/1.0/manifest.json‎

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -11,8 +11,7 @@
1111
"eol_date": "2019-06-27T00:00:00+00:00",
1212
"_links": {
1313
"self": {
14-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/1.0/manifest.json",
15-
"title": ".NET 1.0 Manifest"
14+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/1.0/manifest.json"
1615
},
1716
"downloads-rendered": {
1817
"href": "https://dotnet.microsoft.com/download/dotnet/1.0",
@@ -39,10 +38,5 @@
3938
"title": "Release Notes (Rendered)",
4039
"type": "text/html"
4140
}
42-
},
43-
"_metadata": {
44-
"schema_version": "1.0",
45-
"generated_on": "2025-12-08T02:15:07.0840125+00:00",
46-
"generated_by": "VersionIndex"
4741
}
4842
}

‎release-notes/1.1/index.json‎

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,13 @@
99
"ga_date": "2016-11-16T00:00:00\u002B00:00",
1010
"eol_date": "2019-06-27T00:00:00\u002B00:00",
1111
"_links": {
12+
"self": {
13+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/1.1/index.json"
14+
},
15+
"release-manifest": {
16+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/1.1/manifest.json",
17+
"title": "Release manifest"
18+
},
1219
"releases-index": {
1320
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/index.json",
1421
"title": "Release index"
@@ -31,35 +38,31 @@
3138
"year": "2019",
3239
"_links": {
3340
"self": {
34-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2019/index.json",
35-
"title": ".NET Release Timeline 2019 (chronological)"
41+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2019/index.json"
3642
}
3743
}
3844
},
3945
{
4046
"year": "2018",
4147
"_links": {
4248
"self": {
43-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2018/index.json",
44-
"title": ".NET Release Timeline 2018 (chronological)"
49+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2018/index.json"
4550
}
4651
}
4752
},
4853
{
4954
"year": "2017",
5055
"_links": {
5156
"self": {
52-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2017/index.json",
53-
"title": ".NET Release Timeline 2017 (chronological)"
57+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2017/index.json"
5458
}
5559
}
5660
},
5761
{
5862
"year": "2016",
5963
"_links": {
6064
"self": {
61-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2016/index.json",
62-
"title": ".NET Release Timeline 2016 (chronological)"
65+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2016/index.json"
6366
}
6467
}
6568
}

‎release-notes/1.1/manifest.json‎

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -11,8 +11,7 @@
1111
"eol_date": "2019-06-27T00:00:00+00:00",
1212
"_links": {
1313
"self": {
14-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/1.1/manifest.json",
15-
"title": ".NET 1.1 Manifest"
14+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/1.1/manifest.json"
1615
},
1716
"downloads-rendered": {
1817
"href": "https://dotnet.microsoft.com/download/dotnet/1.1",
@@ -39,10 +38,5 @@
3938
"title": "Release Notes (Rendered)",
4039
"type": "text/html"
4140
}
42-
},
43-
"_metadata": {
44-
"schema_version": "1.0",
45-
"generated_on": "2025-12-08T02:15:07.0558709+00:00",
46-
"generated_by": "VersionIndex"
4741
}
4842
}

‎release-notes/10.0/index.json‎

Lines changed: 18 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,9 @@
1111
"ga_date": "2025-11-11T00:00:00\u002B00:00",
1212
"eol_date": "2028-11-14T00:00:00\u002B00:00",
1313
"_links": {
14+
"self": {
15+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/index.json"
16+
},
1417
"downloads": {
1518
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/downloads/index.json",
1619
"title": ".NET 10.0 Downloads"
@@ -27,6 +30,10 @@
2730
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/10.0.0-rc.2/index.json",
2831
"title": "Latest security patch"
2932
},
33+
"release-manifest": {
34+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/manifest.json",
35+
"title": "Release manifest"
36+
},
3037
"releases-index": {
3138
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/index.json",
3239
"title": "Release index"
@@ -60,8 +67,7 @@
6067
"sdk_release": "10.0.100",
6168
"_links": {
6269
"self": {
63-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/10.0.0/index.json",
64-
"title": "10.0.0 Patch Index"
70+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/10.0.0/index.json"
6571
},
6672
"release-month": {
6773
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2025/11/index.json",
@@ -84,8 +90,7 @@
8490
"sdk_release": "10.0.100-rc.2.25502.107",
8591
"_links": {
8692
"self": {
87-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/preview/rc2/index.json",
88-
"title": "10.0.0-rc.2 Patch Index"
93+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/preview/rc2/index.json"
8994
},
9095
"release-month": {
9196
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2025/10/index.json",
@@ -109,8 +114,7 @@
109114
"sdk_release": "10.0.100-rc.1.25451.107",
110115
"_links": {
111116
"self": {
112-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/preview/rc1/index.json",
113-
"title": "10.0.0-rc.1 Patch Index"
117+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/preview/rc1/index.json"
114118
},
115119
"release-month": {
116120
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2025/09/index.json",
@@ -129,8 +133,7 @@
129133
"sdk_release": "10.0.100-preview.7.25380.108",
130134
"_links": {
131135
"self": {
132-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/preview/preview7/index.json",
133-
"title": "10.0.0-preview.7 Patch Index"
136+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/preview/preview7/index.json"
134137
},
135138
"release-month": {
136139
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2025/08/index.json",
@@ -149,8 +152,7 @@
149152
"sdk_release": "10.0.100-preview.6.25358.103",
150153
"_links": {
151154
"self": {
152-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/preview/preview6/index.json",
153-
"title": "10.0.0-preview.6 Patch Index"
155+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/preview/preview6/index.json"
154156
},
155157
"release-month": {
156158
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2025/07/index.json",
@@ -169,8 +171,7 @@
169171
"sdk_release": "10.0.100-preview.5.25277.114",
170172
"_links": {
171173
"self": {
172-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/preview/preview5/index.json",
173-
"title": "10.0.0-preview.5 Patch Index"
174+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/preview/preview5/index.json"
174175
},
175176
"release-month": {
176177
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2025/06/index.json",
@@ -189,8 +190,7 @@
189190
"sdk_release": "10.0.100-preview.4.25258.110",
190191
"_links": {
191192
"self": {
192-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/preview/preview4/index.json",
193-
"title": "10.0.0-preview.4 Patch Index"
193+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/preview/preview4/index.json"
194194
},
195195
"release-month": {
196196
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2025/05/index.json",
@@ -209,8 +209,7 @@
209209
"sdk_release": "10.0.100-preview.3.25201.16",
210210
"_links": {
211211
"self": {
212-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/preview/preview3/index.json",
213-
"title": "10.0.0-preview.3 Patch Index"
212+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/preview/preview3/index.json"
214213
},
215214
"release-month": {
216215
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2025/04/index.json",
@@ -229,8 +228,7 @@
229228
"sdk_release": "10.0.100-preview.2.25164.34",
230229
"_links": {
231230
"self": {
232-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/preview/preview2/index.json",
233-
"title": "10.0.0-preview.2 Patch Index"
231+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/preview/preview2/index.json"
234232
},
235233
"release-month": {
236234
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2025/03/index.json",
@@ -249,8 +247,7 @@
249247
"sdk_release": "10.0.100-preview.1.25120.13",
250248
"_links": {
251249
"self": {
252-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/preview/preview1/index.json",
253-
"title": "10.0.0-preview.1 Patch Index"
250+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/preview/preview1/index.json"
254251
},
255252
"release-month": {
256253
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2025/02/index.json",
@@ -264,8 +261,7 @@
264261
"year": "2025",
265262
"_links": {
266263
"self": {
267-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2025/index.json",
268-
"title": ".NET Release Timeline 2025 (chronological)"
264+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/timeline/2025/index.json"
269265
}
270266
}
271267
}

‎release-notes/10.0/manifest.json‎

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -11,8 +11,7 @@
1111
"eol_date": "2028-11-14T00:00:00+00:00",
1212
"_links": {
1313
"self": {
14-
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/manifest.json",
15-
"title": ".NET 10.0 Manifest"
14+
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/10.0/manifest.json"
1615
},
1716
"compatibility-rendered": {
1817
"href": "https://learn.microsoft.com/dotnet/core/compatibility/10.0",
@@ -64,10 +63,5 @@
6463
"title": "What\u0027s new in .NET 10",
6564
"type": "text/html"
6665
}
67-
},
68-
"_metadata": {
69-
"schema_version": "1.0",
70-
"generated_on": "2025-12-08T02:15:07.05611+00:00",
71-
"generated_by": "VersionIndex"
7266
}
7367
}

0 commit comments

Comments
 (0)