docs: style linting (#6260)

also fixes some links

---------

Co-authored-by: Sydney Runkle <54324534+sydney-runkle@users.noreply.github.com>
Co-authored-by: ccurme <chester.curme@gmail.com>
Co-authored-by: Sydney Runkle <sydneymarierunkle@gmail.com>
Co-authored-by: William FH <13333726+hinthornw@users.noreply.github.com>

docs/_scripts/handle_auto_links.py

@@ -29,7 +29,11 @@ logger = logging.getLogger(__name__)
 
 
 def _transform_link(
-    link_name: str, scope: str, file_path: str, line_number: int, custom_title: Optional[str] = None
+    link_name: str,
+    scope: str,
+    file_path: str,
+    line_number: int,
+    custom_title: Optional[str] = None,
 ) -> Optional[str]:
     """Transform a cross-reference link based on the current scope.
 
@@ -38,7 +42,7 @@ def _transform_link(
         scope: The current scope context ("global", "python", "js", etc.).
         file_path: The file path for error reporting.
         line_number: The line number for error reporting.
-        custom_title: Optional custom title for the link. If None, uses link_name.
+        custom_title: Optional custom title for the link. If `None`, uses link_name.
 
     Returns:
         A formatted markdown link if the link is found in the scope mapping,
@@ -117,7 +121,9 @@ CROSS_REFERENCE_PATTERN = re.compile(
 )
 
 
-def _replace_autolinks(markdown: str, file_path: str, *, default_scope: str = "python") -> str:
+def _replace_autolinks(
+    markdown: str, file_path: str, *, default_scope: str = "python"
+) -> str:
     """Preprocess markdown lines to handle @[links] with conditional fence scopes.
 
     This function processes markdown content to transform @[link_name] references
@@ -169,7 +175,7 @@ def _replace_autolinks(markdown: str, file_path: str, *, default_scope: str = "p
                 # This is @[ref] format
                 link_name = match.group("link_name")
                 custom_title = None
-            
+
             transformed = _transform_link(
                 link_name, current_scope, file_path, line_number, custom_title
             )

docs/_scripts/third_party_page/get_download_stats.py

@@ -20,16 +20,19 @@ class Package(TypedDict):
     description: str
     """A brief description of what the package does."""
 
+
 class ResolvedPackage(Package):
     weekly_downloads: int | None
     """The weekly download count of the package."""
     language: str
     """The language of the package. (either 'python' or 'js')"""
 
+
 HERE = pathlib.Path(__file__).parent
 PACKAGES_FILE = HERE / "packages.yml"
 PACKAGES = yaml.safe_load(PACKAGES_FILE.read_text())["packages"]
 
+
 def _get_pypi_downloads(package: Package) -> int:
     """Retrieve the weekly download count for a package from PyPIStats."""
 
@@ -72,7 +75,8 @@ def _get_pypi_downloads(package: Package) -> int:
         return sum(entry["downloads"] for entry in sorted_data[:7])
     else:
         return None
-    
+
+
 def _get_npm_downloads(package: Package) -> int:
     """Retrieve the weekly download count for a package on the npm registry."""
 
@@ -82,14 +86,18 @@ def _get_npm_downloads(package: Package) -> int:
         npm_response = requests.get(npm_url)
         npm_response.raise_for_status()
     except requests.exceptions.HTTPError:
-        raise AssertionError(f"Package {package['name']} does not exist on npm registry")
+        raise AssertionError(
+            f"Package {package['name']} does not exist on npm registry"
+        )
 
     npm_data = npm_response.json()
 
     # Retrieve the first publish date using the 'created' timestamp from the 'time' field.
     created_str = npm_data.get("time", {}).get("created")
     if created_str is None:
-        raise AssertionError(f"Package {package['name']} has no creation time in registry data")
+        raise AssertionError(
+            f"Package {package['name']} has no creation time in registry data"
+        )
     # Remove the trailing 'Z' if present and parse the ISO format timestamp
     first_publish_date = datetime.fromisoformat(created_str.rstrip("Z"))
 
@@ -103,7 +111,10 @@ def _get_npm_downloads(package: Package) -> int:
     else:
         return None
 
-def _get_weekly_downloads(packages: dict[str, list[Package]], fake: bool) -> list[ResolvedPackage]:
+
+def _get_weekly_downloads(
+    packages: dict[str, list[Package]], fake: bool
+) -> list[ResolvedPackage]:
     """Retrieve the weekly download count for a dictionary of python or js packages."""
     resolved_packages: list[ResolvedPackage] = []
 
@@ -131,7 +142,7 @@ def _get_weekly_downloads(packages: dict[str, list[Package]], fake: bool) -> lis
                 num_downloads = _get_npm_downloads(package)
             else:
                 num_downloads = None
-            
+
             resolved_packages.append(
                 {
                     "name": package["name"],
@@ -145,12 +156,13 @@ def _get_weekly_downloads(packages: dict[str, list[Package]], fake: bool) -> lis
 
     return resolved_packages
 
+
 def main(output_file: str, fake: bool) -> None:
     """Main function to generate package download information.
 
     Args:
         output_file: Path to the output YAML file.
-        fake: If True, use fake download counts for testing purposes.
+        fake: If `True`, use fake download counts for testing purposes.
     """
     resolved_packages: list[ResolvedPackage] = _get_weekly_downloads(PACKAGES, fake)