From 447a2e4d1ecbd05b0e656f4320f6d326883556e9 Mon Sep 17 00:00:00 2001 From: Jeffrey Aven Date: Thu, 17 Sep 2026 19:42:14 +1000 Subject: [PATCH] docs: group landing page examples under an Example Queries heading Add an "Example Queries" H2 with an intro sentence to the `openai_admin` provider landing page so the existing example sections nest under a single ToC entry (matching the clickhouse microsite), and regenerate the website landing page. Co-Authored-By: Claude Fable 5.1 --- provider-dev/docgen/provider-data/headerContent2.txt | 8 ++++++-- website/docs/index.md | 8 ++++++-- 2 files changed, 12 insertions(+), 4 deletions(-) diff --git a/provider-dev/docgen/provider-data/headerContent2.txt b/provider-dev/docgen/provider-data/headerContent2.txt index 02d4ed7..ac96321 100644 --- a/provider-dev/docgen/provider-data/headerContent2.txt +++ b/provider-dev/docgen/provider-data/headerContent2.txt @@ -43,7 +43,11 @@ stackql.exe shell --auth=$Auth ``` -## Token spend and cost as rows +## Example Queries + +Try the following queries using `stackql shell`, or run them from a script or CI pipeline with `stackql exec`. + +### Token spend and cost as rows Usage and cost are bucketed time series. Each row is one time bucket (`start_time`, `end_time`) and its `results` array holds the per-group breakdown, fanned out with `json_each` and read with `json_extract`. @@ -90,7 +94,7 @@ WHERE start_time = 1781481600 AND "limit" = 180; ``` -## Governance and audit +### Governance and audit Projects, their service accounts, and their API keys as rows: diff --git a/website/docs/index.md b/website/docs/index.md index d6299ed..4fe3447 100644 --- a/website/docs/index.md +++ b/website/docs/index.md @@ -81,7 +81,11 @@ stackql.exe shell --auth=$Auth ``` -## Token spend and cost as rows +## Example Queries + +Try the following queries using `stackql shell`, or run them from a script or CI pipeline with `stackql exec`. + +### Token spend and cost as rows Usage and cost are bucketed time series. Each row is one time bucket (`start_time`, `end_time`) and its `results` array holds the per-group breakdown, fanned out with `json_each` and read with `json_extract`. @@ -128,7 +132,7 @@ WHERE start_time = 1781481600 AND "limit" = 180; ``` -## Governance and audit +### Governance and audit Projects, their service accounts, and their API keys as rows: