From 569cdca1ba94febac07a23bfb36680fabb312d6e Mon Sep 17 00:00:00 2001
From: Sajith15 <kpsajith2000@gmail.com>
Date: Wed, 10 Jun 2026 20:07:59 +0530
Subject: [PATCH] docs: update deprecated documentation URLs and add font URL
 deprecation note

- Update material design guidelines link from defunct material.io/guidelines/
  to specific m2.material.io/design/iconography/system-icons.html page
- Update font/README.md icon browser comment URLs from deprecated
  material.io/resources/icons/ to current fonts.google.com/icons format
- Add deprecation warning in both READMEs for the old
  fonts.googleapis.com/icon?family= URL format, directing users to the
  css2?family= format that replaced it

Closes #1486

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 README.md      |  5 ++++-
 font/README.md | 12 +++++++-----
 2 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 724f231e9d7a..6e5d1d1c1e6f 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@ These are two different official icon sets from Google, using the same underlyin
 
 The icons can be browsed in a more user-friendly way at https://fonts.google.com/icons. Use the popdown menu near top left to choose between the two sets; Material Symbols is the default.
 
-The icons are designed under the [material design guidelines](https://material.io/guidelines/).
+The icons are designed under the [material design guidelines](https://m2.material.io/design/iconography/system-icons.html).
 
 ## Icon Requests
 
@@ -132,6 +132,9 @@ The `font` and `variablefont` folders contain pre-generated font files that can
 <link href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined"
       rel="stylesheet">
 ```
+
+> **Note:** The older `https://fonts.googleapis.com/icon?family=Material+Icons` URL format is deprecated and may fail to load. Use the `css2` URL format shown above instead.
+
 Read more on [Material Symbols](https://developers.google.com/fonts/docs/material_symbols/) or [Material Icons](https://developers.google.com/fonts/docs/material_icons/) in the Google Fonts developer guide.
 
 
diff --git a/font/README.md b/font/README.md
index 7b4e47bc9668..8de27f7aa472 100644
--- a/font/README.md
+++ b/font/README.md
@@ -5,24 +5,26 @@ Material Icons are the non-variable classic icon fonts, while the Material Symbo
 The recommended way to use the Material Icons font is by linking to the web font hosted on Google Fonts:
 
 ```html
-<!-- https://material.io/resources/icons/?style=baseline -->
+<!-- https://fonts.google.com/icons?icon.set=Material+Icons&icon.style=Filled -->
 <link href="https://fonts.googleapis.com/css2?family=Material+Icons"
       rel="stylesheet">
 
-<!-- https://material.io/resources/icons/?style=outline -->
+<!-- https://fonts.google.com/icons?icon.set=Material+Icons&icon.style=Outlined -->
 <link href="https://fonts.googleapis.com/css2?family=Material+Icons+Outlined"
       rel="stylesheet">
 
-<!-- https://material.io/resources/icons/?style=round -->
+<!-- https://fonts.google.com/icons?icon.set=Material+Icons&icon.style=Rounded -->
 <link href="https://fonts.googleapis.com/css2?family=Material+Icons+Round"
       rel="stylesheet">
 
-<!-- https://material.io/resources/icons/?style=sharp -->
+<!-- https://fonts.google.com/icons?icon.set=Material+Icons&icon.style=Sharp -->
 <link href="https://fonts.googleapis.com/css2?family=Material+Icons+Sharp"
       rel="stylesheet">
 
-<!-- https://material.io/resources/icons/?style=twotone -->
+<!-- https://fonts.google.com/icons?icon.set=Material+Icons&icon.style=Two+tone -->
 <link href="https://fonts.googleapis.com/css2?family=Material+Icons+Two+Tone"
       rel="stylesheet">
 ```
 
+> **Note:** The older `https://fonts.googleapis.com/icon?family=Material+Icons` URL format is deprecated and may fail to load. Use the `css2` URL format shown above instead.
+