1# web_fetch policy
2 
3Steps 2 and 3 of the recommender rely on `web_fetch` against `learn.microsoft.com` to verify that a recommendation reflects current capabilities (especially VMSS features, family availability, and Spot eligibility).
4 
5## When `web_fetch` succeeds
6 
7Use the live documentation as the source of truth. Cite the URL in the recommendation so the user can verify.
8 
9## When `web_fetch` fails (timeout, 404, blocked, offline)
10 
11Proceed using the reference files in `../../references/` — but **always** include this warning in the recommendation:
12 
13> ⚠ Unable to verify against latest Azure documentation. Recommendation is based on reference material that may not reflect recent updates (e.g., new VM families, Spot eligibility changes, regional rollouts).
14 
15Do not block the recommendation on `web_fetch` failure. The user is better served by an annotated recommendation than by no recommendation.
16 
17## What to fetch (Step 2 — VMSS)
18 
19```
20https://learn.microsoft.com/azure/virtual-machine-scale-sets/overview
21https://learn.microsoft.com/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-autoscale-overview
22```
23 
24## What to fetch (Step 3 — VM family)
25 
26```
27https://learn.microsoft.com/azure/virtual-machines/sizes/<family-category>/<series-name>
28```
29 
30Examples:
31- B-series: `https://learn.microsoft.com/azure/virtual-machines/sizes/general-purpose/b-family`
32- D-series: `https://learn.microsoft.com/azure/virtual-machines/sizes/general-purpose/ddsv5-series`
33- GPU: `https://learn.microsoft.com/azure/virtual-machines/sizes/gpu-accelerated/nc-family`
34 
35For Spot, also: `https://learn.microsoft.com/azure/virtual-machine-scale-sets/use-spot`.
36