updated window examples

Author: jeffreyaven

docs/language-spec/functions/aggregate/avg.md

@@ -63,4 +63,25 @@ AND zone = 'australia-southeast1-a'
 GROUP BY json_extract(tags, '$.instanceType');
 ```
 
+### Use `AVG` as a window function to calculate moving averages
+
+```sql
+-- Calculate moving average of commit activity
+WITH weekly_totals AS (
+    SELECT
+        week,
+        SUM(json_each.value) as commits_this_week
+    FROM github.repos.stats_commit_activity, JSON_EACH(days)
+    WHERE owner = 'stackql'
+      AND repo = 'stackql'
+    GROUP BY week
+)
+SELECT
+    week,
+    commits_this_week,
+    ROUND(AVG(commits_this_week) OVER (ORDER BY week ROWS BETWEEN 3 PRECEDING AND CURRENT ROW), 1) as four_week_moving_avg
+FROM weekly_totals
+ORDER BY week;
+```
+
 For more information, see [https://www.sqlite.org/lang_aggfunc.html#avg](https://www.sqlite.org/lang_aggfunc.html#avg).

docs/language-spec/functions/aggregate/count.md

@@ -61,4 +61,21 @@ AND zone = 'australia-southeast1-a'
 GROUP BY json_extract(tags, '$.instanceType');
 ```
 
+### Use `COUNT` as a window function to calculate cumulative counts
+
+```sql
+-- Track cumulative issue counts over time
+SELECT
+    number,
+    title,
+    state,
+    created_at,
+    COUNT(*) OVER (ORDER BY created_at) as cumulative_issues,
+    COUNT(*) OVER (PARTITION BY state ORDER BY created_at) as cumulative_by_state
+FROM github.issues.issues
+WHERE owner = 'stackql'
+  AND repo = 'stackql'
+ORDER BY created_at;
+```
+
 For more information, see [https://www.sqlite.org/lang_aggfunc.html#count](https://www.sqlite.org/lang_aggfunc.html#count).

docs/language-spec/functions/aggregate/max.md

@@ -91,4 +91,20 @@ WHERE project = 'stackql-demo'
 AND zone = 'australia-southeast1-a';
 ```
 
+### Use `MAX` as a window function to find maximum values within partitions
+
+```sql
+-- Find the most recent issue in each state
+SELECT
+    number,
+    title,
+    state,
+    created_at,
+    MAX(created_at) OVER (PARTITION BY state) as latest_in_state
+FROM github.issues.issues
+WHERE owner = 'stackql'
+  AND repo = 'stackql'
+ORDER BY state, created_at DESC;
+```
+
 For more information, see [https://www.sqlite.org/lang_aggfunc.html#max_agg](https://www.sqlite.org/lang_aggfunc.html#max_agg) or [https://www.sqlite.org/lang_corefunc.html#max_scalar](https://www.sqlite.org/lang_corefunc.html#max_scalar)

docs/language-spec/functions/aggregate/min.md

@@ -91,4 +91,20 @@ WHERE project = 'stackql-demo'
 AND zone = 'australia-southeast1-a';
 ```
 
+### Use `MIN` as a window function to find minimum values within partitions
+
+```sql
+-- Find the earliest issue in each state
+SELECT
+    number,
+    title,
+    state,
+    created_at,
+    MIN(created_at) OVER (PARTITION BY state) as earliest_in_state
+FROM github.issues.issues
+WHERE owner = 'stackql'
+  AND repo = 'stackql'
+ORDER BY state, created_at;
+```
+
 For more information, see [https://www.sqlite.org/lang_aggfunc.html#min_agg](https://www.sqlite.org/lang_aggfunc.html#min_agg) or [https://www.sqlite.org/lang_corefunc.html#min_scalar](https://www.sqlite.org/lang_corefunc.html#min_scalar)

docs/language-spec/functions/aggregate/sum.md

@@ -69,4 +69,19 @@ AND zone = 'australia-southeast1-a'
 GROUP BY json_extract(tags, '$.instanceType');
 ```
 
+### Use `SUM` as a window function to calculate running totals
+
+```sql
+-- Calculate running total and percentage of contributions
+SELECT
+    login,
+    contributions,
+    SUM(contributions) OVER (ORDER BY contributions DESC) as running_total,
+    SUM(contributions) OVER () as total_contributions,
+    ROUND(100.0 * contributions / SUM(contributions) OVER (), 2) as pct_of_total
+FROM github.repos.contributors
+WHERE owner = 'stackql'
+  AND repo = 'stackql';
+```
+
 For more information, see [https://www.sqlite.org/lang_aggfunc.html#sumunc](https://www.sqlite.org/lang_aggfunc.html#sumunc).

docs/language-spec/windowing_functions.md

@@ -76,10 +76,10 @@ type="windowSpec"
 
 | Category | Functions |
 |----------|-----------|
-| **Ranking** | `ROW_NUMBER()`, `RANK()`, `DENSE_RANK()`, `NTILE()` |
-| **Offset** | `LAG()`, `LEAD()`, `FIRST_VALUE()`, `LAST_VALUE()`, `NTH_VALUE()` |
-| **Distribution** | `PERCENT_RANK()`, `CUME_DIST()` |
-| **Aggregate** | `SUM()`, `COUNT()`, `AVG()`, `MIN()`, `MAX()` with `OVER` clause |
+| **Ranking** | [__`ROW_NUMBER()`__](/docs/language-spec/functions/window/row_number), [__`RANK()`__](/docs/language-spec/functions/window/rank), [__`DENSE_RANK()`__](/docs/language-spec/functions/window/dense_rank), [__`NTILE()`__](/docs/language-spec/functions/window/ntile) |
+| **Offset** | [__`LAG()`__](/docs/language-spec/functions/window/lag), [__`LEAD()`__](/docs/language-spec/functions/window/lead), [__`FIRST_VALUE()`__](/docs/language-spec/functions/window/first_value), [__`LAST_VALUE()`__](/docs/language-spec/functions/window/last_value), [__`NTH_VALUE()`__](/docs/language-spec/functions/window/nth_value) |
+| **Distribution** | [__`PERCENT_RANK()`__](/docs/language-spec/functions/window/percent_rank), [__`CUME_DIST()`__](/docs/language-spec/functions/window/cume_dist) |
+| **Aggregate** | [__`SUM()`__](/docs/language-spec/functions/aggregate/sum), [__`COUNT()`__](/docs/language-spec/functions/aggregate/count), [__`AVG()`__](/docs/language-spec/functions/aggregate/avg), [__`MIN()`__](/docs/language-spec/functions/aggregate/min), [__`MAX()`__](/docs/language-spec/functions/aggregate/max) with the __`OVER`__ clause |
 
 * * *