From d8963c55f780f930939c2e70a12c0c24ded2ae17 Mon Sep 17 00:00:00 2001
From: hangyu <jhy03261997@gmail.com>
Date: Thu, 26 Dec 2024 14:57:31 -0800
Subject: [PATCH 1/2] lint

update deep link guide
---
 src/content/cookbook/navigation/set-up-app-links.md   | 11 ++++++++---
 .../cookbook/navigation/set-up-universal-links.md     |  5 +++++
 2 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/src/content/cookbook/navigation/set-up-app-links.md b/src/content/cookbook/navigation/set-up-app-links.md
index d91625a869e..1d10c19503f 100644
--- a/src/content/cookbook/navigation/set-up-app-links.md
+++ b/src/content/cookbook/navigation/set-up-app-links.md
@@ -96,7 +96,13 @@ It provides a simple API to handle complex routing scenarios.
         <data android:scheme="https" />
     </intent-filter>
     ```
-   
+    :::note
+      If you use a flutter version earlier than 3.27,
+      you need to manually opt in to flutter deep link by  
+      adding the following metadata tag to `<activity>`: 
+    ```<meta-data android:name="flutter_deeplinking_enabled" android:value="true" />```
+    :::
+
     :::note
     If you use a third-party plugin to handle deep links,
     such as [app_links][], 
@@ -104,9 +110,8 @@ It provides a simple API to handle complex routing scenarios.
     break these plugins. 
     
     To opt out of using Flutter's default deep link handler,
-     add the following metadata tag:
+     add the following metadata tag to `<activity>`:
     ```<meta-data android:name="flutter_deeplinking_enabled" android:value="false" />```
-    to opt out of Flutter's default deeplink handler 
     :::
 
 ## 3. Hosting assetlinks.json file
diff --git a/src/content/cookbook/navigation/set-up-universal-links.md b/src/content/cookbook/navigation/set-up-universal-links.md
index 604f1ffa0e5..fad1937484f 100644
--- a/src/content/cookbook/navigation/set-up-universal-links.md
+++ b/src/content/cookbook/navigation/set-up-universal-links.md
@@ -82,6 +82,11 @@ It provides a simple API to handle complex routing scenarios.
 1. Open the `ios/Runner.xcworkspace` file inside the
    Flutter project's `ios` folder.
 
+  :::note
+  If you use a flutter version earlier than 3.27,
+  you need to manually opt in to flutter deep link by 
+  adding the key and value pair `FlutterDeepLinkingEnabled` and `YES` to info.Plist.
+  :::
   :::note
   If you are using third-party plugins to handle deep links, 
   such as [app_links][],

From d2c7ef57554e7466a3ac37972dd9f44c5c41d57a Mon Sep 17 00:00:00 2001
From: Parker Lougheed <parlough@gmail.com>
Date: Wed, 1 Jan 2025 14:36:26 +0800
Subject: [PATCH 2/2] Use version note and clean up markdown formatting

---
 .../cookbook/navigation/set-up-app-links.md   | 27 ++++++++++-------
 .../navigation/set-up-universal-links.md      | 29 ++++++++++---------
 2 files changed, 32 insertions(+), 24 deletions(-)

diff --git a/src/content/cookbook/navigation/set-up-app-links.md b/src/content/cookbook/navigation/set-up-app-links.md
index 1d10c19503f..af5e80210ec 100644
--- a/src/content/cookbook/navigation/set-up-app-links.md
+++ b/src/content/cookbook/navigation/set-up-app-links.md
@@ -96,22 +96,29 @@ It provides a simple API to handle complex routing scenarios.
         <data android:scheme="https" />
     </intent-filter>
     ```
-    :::note
-      If you use a flutter version earlier than 3.27,
-      you need to manually opt in to flutter deep link by  
-      adding the following metadata tag to `<activity>`: 
-    ```<meta-data android:name="flutter_deeplinking_enabled" android:value="true" />```
+
+    :::version-note
+    If you use a Flutter version earlier than 3.27,
+    you need to manually opt in to deep linking by
+    adding the following metadata tag to `<activity>`:
+
+    ```xml
+    <meta-data android:name="flutter_deeplinking_enabled" android:value="true" />
+    ```
     :::
 
     :::note
     If you use a third-party plugin to handle deep links,
-    such as [app_links][], 
+    such as [app_links][],
     Flutter's default deeplink handler will
-    break these plugins. 
-    
+    break these plugins.
+
     To opt out of using Flutter's default deep link handler,
-     add the following metadata tag to `<activity>`:
-    ```<meta-data android:name="flutter_deeplinking_enabled" android:value="false" />```
+    add the following metadata tag to `<activity>`:
+
+    ```xml
+    <meta-data android:name="flutter_deeplinking_enabled" android:value="false" />
+    ```
     :::
 
 ## 3. Hosting assetlinks.json file
diff --git a/src/content/cookbook/navigation/set-up-universal-links.md b/src/content/cookbook/navigation/set-up-universal-links.md
index fad1937484f..87fe90fb703 100644
--- a/src/content/cookbook/navigation/set-up-universal-links.md
+++ b/src/content/cookbook/navigation/set-up-universal-links.md
@@ -82,20 +82,21 @@ It provides a simple API to handle complex routing scenarios.
 1. Open the `ios/Runner.xcworkspace` file inside the
    Flutter project's `ios` folder.
 
-  :::note
-  If you use a flutter version earlier than 3.27,
-  you need to manually opt in to flutter deep link by 
-  adding the key and value pair `FlutterDeepLinkingEnabled` and `YES` to info.Plist.
-  :::
-  :::note
-  If you are using third-party plugins to handle deep links, 
-  such as [app_links][],
-  Flutter's default deeplink handler will
-  break these plugins. 
-
-  If you use a third-party plugin,
-  add the key and value pair `FlutterDeepLinkingEnabled` and `NO` to info.Plist.
-  :::
+   :::version-note
+   If you use a Flutter version earlier than 3.27,
+   you need to manually opt in to deep linking by adding the
+   key and value pair `FlutterDeepLinkingEnabled` and `YES` to `info.Plist`.
+   :::
+
+   :::note
+   If you're using third-party plugins to handle deep links, 
+   such as [app_links][],
+   Flutter's default deeplink handler will
+   break these plugins.
+
+   If you use a third-party plugin, add the
+   key and value pair `FlutterDeepLinkingEnabled` and `NO` to `info.Plist`.
+   :::
 
 ### Add associated domains