|
| 1 | +--- |
| 2 | +name: whats-new |
| 3 | +description: Release highlights, new features, and announcements for .NET versions |
| 4 | +--- |
| 5 | + |
| 6 | +# What's New Queries |
| 7 | + |
| 8 | +## Stop Criteria |
| 9 | + |
| 10 | +**STOP when you have the manifest.json.** It contains links to "What's New" docs and release blog posts. These are `-rendered` links (HTML pages)—fetch only if you need to summarize content. |
| 11 | + |
| 12 | +## Quick Answers (from manifest.json) |
| 13 | + |
| 14 | +Once you have `manifest.json._links`: |
| 15 | + |
| 16 | +- What's new docs URL? → `whats-new-rendered.href` |
| 17 | +- Release announcement URL? → `release-blog-rendered.href` |
| 18 | +- Downloads page? → `downloads-rendered.href` |
| 19 | + |
| 20 | +## Navigation Flow (2 fetches for URLs, 3 to read content) |
| 21 | + |
| 22 | +``` |
| 23 | +llms.json |
| 24 | + │ |
| 25 | + └─► _embedded.latest_patches[] ─► _links["release-manifest"] |
| 26 | + │ |
| 27 | + ▼ |
| 28 | + manifest.json |
| 29 | + │ |
| 30 | + ├─► _links["whats-new-rendered"] ─► Microsoft Learn (HTML) |
| 31 | + │ |
| 32 | + └─► _links["release-blog-rendered"] ─► DevBlogs announcement (HTML) |
| 33 | +``` |
| 34 | + |
| 35 | +## Common Queries |
| 36 | + |
| 37 | +### What's new in .NET X? (2-3 fetches) |
| 38 | + |
| 39 | +1. `llms.json` → find version in `_embedded.latest_patches[]` |
| 40 | +2. Follow `_links["release-manifest"]` → manifest.json |
| 41 | +3. Return `whats-new-rendered.href` or fetch and summarize |
| 42 | + |
| 43 | +### Release announcement for .NET X? (2-3 fetches) |
| 44 | + |
| 45 | +Same path, use `release-blog-rendered.href` |
| 46 | + |
| 47 | +## Available Links |
| 48 | + |
| 49 | +| Relation | Content | |
| 50 | +|----------|---------| |
| 51 | +| `whats-new-rendered` | Microsoft Learn "What's New" overview | |
| 52 | +| `release-blog-rendered` | DevBlogs release announcement | |
| 53 | +| `compatibility` | Breaking changes JSON (see breaking-changes skill) | |
| 54 | +| `compatibility-rendered` | Breaking changes HTML view | |
| 55 | +| `downloads-rendered` | .NET download page | |
| 56 | +| `usage-markdown-rendered` | Runtime/SDK usage guidance | |
| 57 | + |
| 58 | +## Common Mistakes |
| 59 | + |
| 60 | +| Mistake | Why It's Wrong | |
| 61 | +|---------|----------------| |
| 62 | +| Looking for raw markdown | Only `-rendered` (HTML) versions exist for announcements | |
| 63 | +| Constructing docs.microsoft.com URLs | Follow `_links` from manifest | |
| 64 | +| Fetching HTML when URL is enough | If user just needs link, don't fetch the page | |
| 65 | + |
| 66 | +## Tips |
| 67 | + |
| 68 | +- `-rendered` links are HTML (human-friendly), not raw data |
| 69 | +- `whats-new-rendered` has comprehensive feature overview |
| 70 | +- `release-blog-rendered` has highlights and context |
| 71 | +- For LLM summarization, fetch the HTML and extract key points |
0 commit comments