From 3554bc168f26750b5880f8abe7fc0b32bc035257 Mon Sep 17 00:00:00 2001
From: Gina Reynolds <evangeline.mae@gmail.com>
Date: Fri, 17 Apr 2026 11:14:25 -0600
Subject: [PATCH] Add faceting section to gallery for pie charts section

Added section on faceting pie charts with example code.
---
 doc/gallery/examples/pie-chart.qmd | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/doc/gallery/examples/pie-chart.qmd b/doc/gallery/examples/pie-chart.qmd
index 52c00d71..a45616f4 100644
--- a/doc/gallery/examples/pie-chart.qmd
+++ b/doc/gallery/examples/pie-chart.qmd
@@ -98,3 +98,18 @@ VISUALISE island AS fill FROM ggsql:penguins
   PROJECT TO polar SETTING start => -90, end => 90
   SCALE angle SETTING expand => 0
 ```
+
+
+### Faceting pie charts
+
+When faceting, you will typically want to pies to be whole, which requires the `SETTING free => 'angle'` specification.
+
+```{ggsql}
+VISUALISE island AS fill FROM ggsql:penguins
+  DRAW bar
+  PROJECT TO polar 
+  FACET species SETTING free => 'angle'
+```
+
+
+