docs: Add migration link in the changelog and add index page for guides (#3471)

Author: paul-ohl

CHANGELOG.md

@@ -1,5 +1,7 @@
 # Changelog
 
+[Link to all migration guides](https://yew.rs/docs/category/migration-guides)
+
 ## ✨ yew **0.23.0** *(2026-03-10)*
 
 bumping from 0.22 should require no code changes for most users.
@@ -148,7 +150,6 @@ Yew pinned to 0.23 now.
 
  - **MSRV raised to 1.84.0.** [[@Siyuan Yan](https://github.com/Madoshakalaka), [#3900](https://github.com/yewstack/yew/pull/3900)]
 
-
 ## ✨ yew **0.21.0** *(2023-09-23)*
 
 Users can follow the [migration guide](https://yew.rs/docs/migration-guides/yew/from-0_20_0-to-0_21_0) to migrate from 0.20.0 to 0.21.0.

tools/changelog/src/write_changelog_file.rs

@@ -20,7 +20,8 @@ pub fn write_changelog(changelog_path: &str, version_changelog: &[u8]) -> Result
 
     new_changelog.write_all(version_changelog)?;
 
-    for old_line in old_changelog_reader.lines().skip(2) {
+    // The `.skip` skips the title and link to the migration guide
+    for old_line in old_changelog_reader.lines().skip(4) {
         writeln!(new_changelog, "{}", old_line?)?;
     }
 

tools/changelog/src/write_version_changelog.rs

@@ -17,6 +17,12 @@ pub fn write_changelog_file(
     writeln!(version_only_changelog, "# Changelog")?;
     writeln!(version_only_changelog)?;
 
+    writeln!(
+        version_only_changelog,
+        "[Link to all migration guides](https://yew.rs/docs/category/migration-guides)"
+    )?;
+    writeln!(version_only_changelog)?;
+
     writeln!(
         version_only_changelog,
         "## ✨ {package} **{next_version}** *({release_date})*",

tools/changelog/tests/generate_yew_changelog_file.rs

@@ -62,7 +62,7 @@ fn generate_yew_changelog_file() -> Result<()> {
     let lines = expected_reader_lines.zip(after_reader_lines);
 
     for (i, (expected_line, after_line)) in lines.enumerate() {
-        if i == 2 || i == 13 {
+        if i == 4 || i == 15 {
             // these lines have dynamic things that may break the tests
             let expected_line_updated = expected_line?.replace(
                 "date_goes_here",

tools/changelog/tests/test_base.md

@@ -1,5 +1,7 @@
 # Changelog for its generation tests
 
+[Link to all migration guides](https://yew.rs/docs/category/migration-guides)
+
 ## ✨ yew **0.19.0** *(2021-11-26)*
 
 #### Changelog

tools/changelog/tests/test_expected.md

@@ -1,5 +1,7 @@
 # Changelog
 
+[Link to all migration guides](https://yew.rs/docs/category/migration-guides)
+
 ## ✨ yew **0.0.0** *(date_goes_here)*
 
 ### ⚡️ Features

website/i18n/ja/docusaurus-plugin-content-docs/current.json

@@ -82,5 +82,21 @@
   "sidebar.docs.category.Struct Components": {
     "message": "Struct Components",
     "description": "The label for category Struct Components in sidebar docs"
+  },
+  "sidebar.docs.category.Migration guides.link.generated-index.title": {
+    "message": "移行ガイド",
+    "description": "The generated-index page title for category Migration guides in sidebar docs"
+  },
+  "sidebar.docs.category.yew.link.generated-index.title": {
+    "message": "yew",
+    "description": "The generated-index page title for category yew in sidebar docs"
+  },
+  "sidebar.docs.category.yew-agent.link.generated-index.title": {
+    "message": "yew-agent",
+    "description": "The generated-index page title for category yew-agent in sidebar docs"
+  },
+  "sidebar.docs.category.yew-router.link.generated-index.title": {
+    "message": "yew-router",
+    "description": "The generated-index page title for category yew-router in sidebar docs"
   }
 }

website/i18n/ja/docusaurus-plugin-content-docs/version-0.20.json

@@ -82,5 +82,21 @@
   "sidebar.docs.category.yew-router": {
     "message": "yew-router",
     "description": "The label for category yew-router in sidebar docs"
+  },
+  "sidebar.docs.category.Migration guides.link.generated-index.title": {
+    "message": "移行ガイド",
+    "description": "The generated-index page title for category Migration guides in sidebar docs"
+  },
+  "sidebar.docs.category.yew.link.generated-index.title": {
+    "message": "yew",
+    "description": "The generated-index page title for category yew in sidebar docs"
+  },
+  "sidebar.docs.category.yew-agent.link.generated-index.title": {
+    "message": "yew-agent",
+    "description": "The generated-index page title for category yew-agent in sidebar docs"
+  },
+  "sidebar.docs.category.yew-router.link.generated-index.title": {
+    "message": "yew-router",
+    "description": "The generated-index page title for category yew-router in sidebar docs"
   }
 }

website/i18n/ja/docusaurus-plugin-content-docs/version-0.21.json

@@ -82,5 +82,21 @@
   "sidebar.docs.category.yew-router": {
     "message": "yew-router",
     "description": "The label for category yew-router in sidebar docs"
+  },
+  "sidebar.docs.category.Migration guides.link.generated-index.title": {
+    "message": "移行ガイド",
+    "description": "The generated-index page title for category Migration guides in sidebar docs"
+  },
+  "sidebar.docs.category.yew.link.generated-index.title": {
+    "message": "yew",
+    "description": "The generated-index page title for category yew in sidebar docs"
+  },
+  "sidebar.docs.category.yew-agent.link.generated-index.title": {
+    "message": "yew-agent",
+    "description": "The generated-index page title for category yew-agent in sidebar docs"
+  },
+  "sidebar.docs.category.yew-router.link.generated-index.title": {
+    "message": "yew-router",
+    "description": "The generated-index page title for category yew-router in sidebar docs"
   }
 }

website/i18n/ja/docusaurus-plugin-content-docs/version-0.22.json

@@ -82,5 +82,21 @@
   "sidebar.docs.category.Struct Components": {
     "message": "Struct Components",
     "description": "The label for category Struct Components in sidebar docs"
+  },
+  "sidebar.docs.category.Migration guides.link.generated-index.title": {
+    "message": "移行ガイド",
+    "description": "The generated-index page title for category Migration guides in sidebar docs"
+  },
+  "sidebar.docs.category.yew.link.generated-index.title": {
+    "message": "yew",
+    "description": "The generated-index page title for category yew in sidebar docs"
+  },
+  "sidebar.docs.category.yew-agent.link.generated-index.title": {
+    "message": "yew-agent",
+    "description": "The generated-index page title for category yew-agent in sidebar docs"
+  },
+  "sidebar.docs.category.yew-router.link.generated-index.title": {
+    "message": "yew-router",
+    "description": "The generated-index page title for category yew-router in sidebar docs"
   }
 }