From add5822909b7396e48c9ec79e7980af0343f3583 Mon Sep 17 00:00:00 2001
From: Dan Redding <125183946+dangotbanned@users.noreply.github.com>
Date: Thu, 3 Oct 2024 15:11:54 +0100
Subject: [PATCH 1/2] docs: Adds example Calculate Residuals (#3625)

---
 .../calculate_residuals.py                    | 37 +++++++++++++++++++
 .../calculate_residuals.py                    | 33 +++++++++++++++++
 2 files changed, 70 insertions(+)
 create mode 100644 tests/examples_arguments_syntax/calculate_residuals.py
 create mode 100644 tests/examples_methods_syntax/calculate_residuals.py

diff --git a/tests/examples_arguments_syntax/calculate_residuals.py b/tests/examples_arguments_syntax/calculate_residuals.py
new file mode 100644
index 000000000..b8e8fe227
--- /dev/null
+++ b/tests/examples_arguments_syntax/calculate_residuals.py
@@ -0,0 +1,37 @@
+"""
+Calculate Residuals
+-------------------
+A dot plot showing each movie in the database, and the difference from the average movie rating.
+The display is sorted by year to visualize everything in sequential order. 
+The graph is for all Movies before 2019.
+
+Adapted from `Calculate Residuals <https://vega.github.io/vega-lite/examples/joinaggregate_residual_graph.html>`_.
+"""
+# category: advanced calculations
+
+import altair as alt
+from vega_datasets import data
+
+imdb_rating = alt.datum["IMDB_Rating"]
+source = data.movies.url
+
+chart = (
+    alt.Chart(source)
+    .mark_point()
+    .transform_filter(imdb_rating != None)
+    .transform_filter(
+        alt.FieldRangePredicate("Release_Date", [None, 2019], timeUnit="year")
+    )
+    .transform_joinaggregate(Average_Rating="mean(IMDB_Rating)")
+    .transform_calculate(Rating_Delta=imdb_rating - alt.datum.Average_Rating)
+    .encode(
+        x=alt.X("Release_Date:T", title="Release Date"),
+        y=alt.Y("Rating_Delta:Q", title="Rating Delta"),
+        color=alt.Color(
+            "Rating_Delta:Q",
+            title="Rating Delta",
+            scale=alt.Scale(domainMid=0),
+        ),
+    )
+)
+chart
\ No newline at end of file
diff --git a/tests/examples_methods_syntax/calculate_residuals.py b/tests/examples_methods_syntax/calculate_residuals.py
new file mode 100644
index 000000000..bb53fb788
--- /dev/null
+++ b/tests/examples_methods_syntax/calculate_residuals.py
@@ -0,0 +1,33 @@
+"""
+Calculate Residuals
+-------------------
+A dot plot showing each movie in the database, and the difference from the average movie rating.
+The display is sorted by year to visualize everything in sequential order. 
+The graph is for all Movies before 2019.
+
+Adapted from `Calculate Residuals <https://vega.github.io/vega-lite/examples/joinaggregate_residual_graph.html>`_.
+"""
+# category: advanced calculations
+
+import altair as alt
+from vega_datasets import data
+
+imdb_rating = alt.datum["IMDB_Rating"]
+source = data.movies.url
+
+chart = (
+    alt.Chart(source)
+    .mark_point()
+    .transform_filter(imdb_rating != None)
+    .transform_filter(
+        alt.FieldRangePredicate("Release_Date", [None, 2019], timeUnit="year")
+    )
+    .transform_joinaggregate(Average_Rating="mean(IMDB_Rating)")
+    .transform_calculate(Rating_Delta=imdb_rating - alt.datum.Average_Rating)
+    .encode(
+        x=alt.X("Release_Date:T").title("Release Date"),
+        y=alt.Y("Rating_Delta:Q").title("Rating Delta"),
+        color=alt.Color("Rating_Delta:Q").title("Rating Delta").scale(domainMid=0),
+    )
+)
+chart
\ No newline at end of file

From d4c3bcfdd3f309178dcde85f9d20a70c9989d13a Mon Sep 17 00:00:00 2001
From: Dan Redding <125183946+dangotbanned@users.noreply.github.com>
Date: Thu, 3 Oct 2024 15:23:18 +0100
Subject: [PATCH 2/2] ci: Use `breaking`, `deprecation` labels in changelog
 (#3623)

---
 .github/release.yml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/.github/release.yml b/.github/release.yml
index b319eeb01..f11bb69fd 100644
--- a/.github/release.yml
+++ b/.github/release.yml
@@ -1,5 +1,11 @@
 changelog:
   categories:
+    - title: Breaking
+      labels:
+        - breaking
+    - title: Deprecation
+      labels:
+        - deprecation
     - title: Enhancements
       labels:
         - enhancement