Auto-update documentation (#19109)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: Alex Streed <[email protected]>

Author: github-actions[bot]

docs/docs.json

@@ -2418,4 +2418,4 @@
     }
   ],
   "theme": "mint"
-}
+}

docs/v3/examples/index.mdx

@@ -15,25 +15,25 @@ Have an example to share? Check out our [contributing guide](/contribute/docs-co
         <Card title="Hello, world!" icon="play" href="/v3/examples/hello-world">
             Your first steps with Prefect – learn how to create a basic flow and understand core concepts.
         </Card>
-        
+
 
         <Card title="API-sourced ETL" icon="database" href="/v3/examples/run-api-sourced-etl">
             Build a small ETL pipeline that fetches JSON from a public API, transforms it with pandas, and writes a CSV – all orchestrated by Prefect.
         </Card>
-        
+
 
         <Card title="dbt Model Orchestration" icon="database" href="/v3/examples/run-dbt-with-prefect">
             Orchestrate any dbt project with bullet-proof retries, observability, and a single Python file – no YAML or shell scripts required.
         </Card>
-        
+
 
         <Card title="Social Analytics Dashboard" icon="chart-bar" href="/v3/examples/atproto-dashboard-with-prefect-assets">
             Build a social media analytics dashboard using Prefect Assets, ATProto/Bluesky APIs, dbt transformations, and Streamlit visualization.
         </Card>
-        
+
 
         <Card title="Simple web scraper" icon="globe" href="/v3/examples/simple-web-scraper">
             Learn how to scrape article content from web pages with Prefect tasks, retries, and automatic logging.
         </Card>
-        
+
 </CardGroup>

examples/atproto_dashboard_with_prefect_assets.py

@@ -7,6 +7,7 @@
 # tags: [assets, social-media, analytics, dbt, streamlit, atproto, bluesky]
 # github_url: https://github.com/zzstoatzz/atproto-dashboard
 # draft: false
+# order: 4
 # ---
 #
 # **Build data pipelines with Prefect Assets – declarative, dependency-aware, and observable.**

examples/hello_world.py

@@ -5,6 +5,7 @@
 # dependencies: ["prefect"]
 # keywords: ["getting_started", "basics"]
 # draft: false
+# order: 1
 # ---
 #
 # Welcome to your first Prefect flow. In under a minute you will:

examples/run_api_sourced_etl.py

@@ -5,6 +5,7 @@
 # dependencies: ["prefect", "httpx", "pandas"]
 # keywords: ["getting_started", "etl", "pandas"]
 # draft: false
+# order: 2
 # ---
 #
 # Prefect turns everyday Python into production-grade workflows with **zero boilerplate**.

examples/run_dbt_with_prefect.py

@@ -5,6 +5,7 @@
 # dependencies: ["prefect", "prefect-dbt>=0.7.0rc1", "dbt-core", "dbt-duckdb"]
 # keywords: ["dbt", "materialization", "tasks", "analytics"]
 # draft: false
+# order: 3
 # ---
 #
 # **Transform unreliable dbt scripts into production-grade data pipelines with enterprise observability, automatic failure recovery, and zero-downtime deployments.**

examples/simple_web_scraper.py

@@ -5,6 +5,7 @@
 # dependencies: ["prefect", "requests", "beautifulsoup4"]
 # keywords: ["getting_started", "webscraping", "tasks", "retries"]
 # draft: false
+# order: 5
 # ---
 #
 # This example shows how Prefect enhances regular Python code without getting in its way.

scripts/generate_example_pages.py

@@ -28,13 +28,15 @@ class Example:
     description: str
     icon: str
     keywords: list[str]
+    order: int | None = None
 
 
 class Frontmatter(TypedDict, total=False):
     title: str
     description: str
     icon: str
     keywords: list[str]
+    order: int
 
 
 async def get_examples() -> list[Example]:
@@ -52,8 +54,16 @@ async def get_examples() -> list[Example]:
                     description=example_frontmatter.get("description", ""),
                     icon=example_frontmatter.get("icon", ""),
                     keywords=example_frontmatter.get("keywords", []),
+                    order=example_frontmatter.get("order"),
                 )
             )
+    # Sort examples by order field (if present), then by filename
+    examples.sort(
+        key=lambda ex: (
+            ex.order if ex.order is not None else float("inf"),
+            ex.path.name,
+        )
+    )
     return examples