address PR comments

Author: jonathan343

scripts/docs/generate_nav.py

@@ -10,6 +10,7 @@
 import logging
 import sys
 
+from datetime import datetime, timezone
 from pathlib import Path
 
 from generate_all_doc_stubs import discover_clients
@@ -26,6 +27,19 @@
 NAV_START_MARKER = "# >>> AUTO-NAV >>>"
 NAV_END_MARKER = "# <<< AUTO-NAV <<<"
 
+# Markers in zensical.toml that bound the generated `copyright` line.
+COPYRIGHT_START_MARKER = "# >>> AUTO-COPYRIGHT >>>"
+COPYRIGHT_END_MARKER = "# <<< AUTO-COPYRIGHT <<<"
+
+
+def _replace_block(config: str, start: str, end: str, body: str) -> str:
+    """Replace the content between two markers (inclusive of newlines)."""
+    if start not in config or end not in config:
+        raise ValueError(f"Markers not found. Expected '{start}' and '{end}'.")
+    before, _, rest = config.partition(start)
+    _, _, after = rest.partition(end)
+    return f"{before}{start}\n{body}\n{end}{after}"
+
 
 def _toml_key(value: str) -> str:
     """Quote a string for use as a TOML key, escaping as a basic string."""
@@ -91,18 +105,22 @@ def generate_nav(repo_root: Path) -> bool:
         logger.error(f"Failed to read {config_path.name}: {e}")
         return False
 
-    if NAV_START_MARKER not in config or NAV_END_MARKER not in config:
-        logger.error(
-            f"AUTO-NAV markers not found in {config_path.name}. "
-            f"Expected '{NAV_START_MARKER}' and '{NAV_END_MARKER}'."
+    year = datetime.now(timezone.utc).year
+    copyright_line = (
+        f'copyright = "&copy; {year}, Amazon Web Services, Inc. '
+        f'or its affiliates. All rights reserved."'
+    )
+    try:
+        updated = _replace_block(
+            config, NAV_START_MARKER, NAV_END_MARKER, build_nav_block(clients_dir)
         )
+        updated = _replace_block(
+            updated, COPYRIGHT_START_MARKER, COPYRIGHT_END_MARKER, copyright_line
+        )
+    except ValueError as e:
+        logger.error(f"Failed to update {config_path.name}: {e}")
         return False
-
-    nav_block = build_nav_block(clients_dir)
-
-    before, _, rest = config.partition(NAV_START_MARKER)
-    _, _, after = rest.partition(NAV_END_MARKER)
-    updated = f"{before}{NAV_START_MARKER}\n{nav_block}\n{NAV_END_MARKER}{after}"
+    logger.info(f"Set copyright year to {year}")
 
     try:
         config_path.write_text(updated)

zensical.toml

@@ -5,9 +5,11 @@ site_name = "AWS SDK for Python"
 site_description = "Documentation for AWS SDK for Python Clients"
 site_author = "Amazon Web Services"
 site_url = "https://docs.aws.amazon.com/sdk-for-python/v1/reference/"
-copyright = """
-Copyright © 2026, Amazon Web Services, Inc
-"""
+# Copyright. The year below is regenerated by scripts/docs/generate_nav.py
+# (run via `make docs-generate`). Do not edit the year by hand.
+# >>> AUTO-COPYRIGHT >>>
+copyright = "© 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved."
+# <<< AUTO-COPYRIGHT <<<
 
 # Repository
 repo_name = "awslabs/aws-sdk-python"
@@ -197,6 +199,8 @@ combine_header_slug = true
 [project.markdown_extensions.pymdownx.tasklist]
 custom_checkbox = true
 [project.markdown_extensions.pymdownx.tilde]
+[project.markdown_extensions.pymdownx.snippets]
+check_paths = true
 
 
 [project.plugins.mkdocstrings.handlers.python]
@@ -224,6 +228,3 @@ filters = [
   "!^deserialize",
   "!^serialize"
 ]
-
-[project.markdown_extensions.pymdownx.snippets]
-check_paths = true