Upgrade to dartdoc 8.3.1 (#8439)

Author: isoos

CHANGELOG.md

@@ -2,6 +2,8 @@ Important changes to data models, configuration, and migrations between each
 AppEngine version, listed here to ease deployment and troubleshooting.
 
 ## Next Release (replace with git tag when deployed)
+ * Bump runtimeVersion to `2024.12.30`.
+ * Upgraded dartdoc to `8.3.1`.
  * Note: removed required flag from `isBlocked` fields. 
  * Note: started deleting `Package.blocked` and `Package.blockedReason`.
 

app/lib/shared/versions.dart

@@ -24,11 +24,10 @@ final RegExp runtimeVersionPattern = RegExp(r'^\d{4}\.\d{2}\.\d{2}$');
 /// when the version switch happens.
 const _acceptedRuntimeVersions = <String>[
   // The current [runtimeVersion].
-  '2024.12.17',
+  '2024.12.30',
   // Fallback runtime versions.
+  '2024.12.17',
   '2024.12.11',
-  '2024.12.09',
-  '2024.12.04',
 ];
 
 /// Sets the current runtime versions.
@@ -75,4 +74,4 @@ final semanticToolStableFlutterSdkVersion =
 final String panaVersion = pana.packageVersion;
 
 // keep in-sync with pkg/pub-worker/lib/src/bin/pana_wrapper.dart
-final String dartdocVersion = '8.3.0';
+final String dartdocVersion = '8.3.1';

app/test/task/testdata/goldens/documentation/oxygen/1.0.0/index.html

@@ -55,7 +55,7 @@ <h2>Libraries</h2>
           <dl>
             <dt id="oxygen">
               <span class="name">
-                <a href="oxygen">oxygen</a>
+                <a href="oxygen/">oxygen</a>
               </span>
             </dt>
             <dd></dd>
@@ -82,7 +82,7 @@ <h5 class="hidden-xs">
         <ol>
           <li class="section-title">Libraries</li>
           <li>
-            <a href="oxygen">oxygen</a>
+            <a href="oxygen/">oxygen</a>
           </li>
         </ol>
         <div id="dartdoc-sidebar-left-content"></div>

app/test/task/testdata/goldens/documentation/oxygen/1.0.0/oxygen/MainClass-class.html

@@ -34,7 +34,7 @@
           <a href="../index.html">documentation</a>
         </li>
         <li>
-          <a href="../oxygen">oxygen.dart</a>
+          <a href="../oxygen/">oxygen.dart</a>
         </li>
         <li class="self-crumb">MainClass class</li>
       </ol>
@@ -243,7 +243,7 @@ <h2>Operators</h2>
             <a href="../index.html">documentation</a>
           </li>
           <li>
-            <a href="../oxygen">oxygen</a>
+            <a href="../oxygen/">oxygen</a>
           </li>
           <li class="self-crumb">MainClass class</li>
         </ol>

app/test/task/testdata/goldens/documentation/oxygen/1.0.0/oxygen/MainClass/MainClass.html

@@ -34,7 +34,7 @@
           <a href="../../index.html">documentation</a>
         </li>
         <li>
-          <a href="../../oxygen">oxygen.dart</a>
+          <a href="../../oxygen/">oxygen.dart</a>
         </li>
         <li>
           <a href="../../oxygen/MainClass-class.html">MainClass</a>
@@ -100,7 +100,7 @@ <h2>
             <a href="../../index.html">documentation</a>
           </li>
           <li>
-            <a href="../../oxygen">oxygen</a>
+            <a href="../../oxygen/">oxygen</a>
           </li>
           <li>
             <a href="../../oxygen/MainClass-class.html">MainClass</a>

app/test/task/testdata/goldens/documentation/oxygen/1.0.0/oxygen/MainClass/text.html

@@ -34,7 +34,7 @@
           <a href="../../index.html">documentation</a>
         </li>
         <li>
-          <a href="../../oxygen">oxygen.dart</a>
+          <a href="../../oxygen/">oxygen.dart</a>
         </li>
         <li>
           <a href="../../oxygen/MainClass-class.html">MainClass</a>
@@ -91,7 +91,7 @@ <h2>
             <a href="../../index.html">documentation</a>
           </li>
           <li>
-            <a href="../../oxygen">oxygen</a>
+            <a href="../../oxygen/">oxygen</a>
           </li>
           <li>
             <a href="../../oxygen/MainClass-class.html">MainClass</a>

app/test/task/testdata/goldens/documentation/oxygen/1.0.0/oxygen/MainClass/toLowerCase.html

@@ -34,7 +34,7 @@
           <a href="../../index.html">documentation</a>
         </li>
         <li>
-          <a href="../../oxygen">oxygen.dart</a>
+          <a href="../../oxygen/">oxygen.dart</a>
         </li>
         <li>
           <a href="../../oxygen/MainClass-class.html">MainClass</a>
@@ -100,7 +100,7 @@ <h2>
             <a href="../../index.html">documentation</a>
           </li>
           <li>
-            <a href="../../oxygen">oxygen</a>
+            <a href="../../oxygen/">oxygen</a>
           </li>
           <li>
             <a href="../../oxygen/MainClass-class.html">MainClass</a>

app/test/task/testdata/goldens/documentation/oxygen/1.0.0/oxygen/MainClass/toString.html

@@ -34,7 +34,7 @@
           <a href="../../index.html">documentation</a>
         </li>
         <li>
-          <a href="../../oxygen">oxygen.dart</a>
+          <a href="../../oxygen/">oxygen.dart</a>
         </li>
         <li>
           <a href="../../oxygen/MainClass-class.html">MainClass</a>
@@ -119,7 +119,7 @@ <h2>
             <a href="../../index.html">documentation</a>
           </li>
           <li>
-            <a href="../../oxygen">oxygen</a>
+            <a href="../../oxygen/">oxygen</a>
           </li>
           <li>
             <a href="../../oxygen/MainClass-class.html">MainClass</a>

app/test/task/testdata/goldens/documentation/oxygen/1.0.0/oxygen/TypeEnum.html

@@ -34,7 +34,7 @@
           <a href="../index.html">documentation</a>
         </li>
         <li>
-          <a href="../oxygen">oxygen.dart</a>
+          <a href="../oxygen/">oxygen.dart</a>
         </li>
         <li class="self-crumb">TypeEnum enum</li>
       </ol>
@@ -297,7 +297,7 @@ <h2>Constants</h2>
             <a href="../index.html">documentation</a>
           </li>
           <li>
-            <a href="../oxygen">oxygen</a>
+            <a href="../oxygen/">oxygen</a>
           </li>
           <li class="self-crumb">TypeEnum enum</li>
         </ol>

app/test/task/testdata/goldens/documentation/oxygen/1.0.0/oxygen/TypeEnum/values-constant.html

@@ -34,7 +34,7 @@
           <a href="../../index.html">documentation</a>
         </li>
         <li>
-          <a href="../../oxygen">oxygen.dart</a>
+          <a href="../../oxygen/">oxygen.dart</a>
         </li>
         <li>
           <a href="../../oxygen/TypeEnum.html">TypeEnum</a>
@@ -92,7 +92,7 @@ <h1>
             <a href="../../index.html">documentation</a>
           </li>
           <li>
-            <a href="../../oxygen">oxygen</a>
+            <a href="../../oxygen/">oxygen</a>
           </li>
           <li>
             <a href="../../oxygen/TypeEnum.html">TypeEnum</a>