aog wip

Author: daslu

src/data_visualization/aog_in_clojure_part1.clj

@@ -138,31 +138,6 @@
 ;; This convention helps you navigate the document and quickly find what you're looking for:
 ;; conceptual explanations (📖), working code (⚙️), or usage examples (🧪).
 
-;; ### 📖 Notebook Structure
-;;
-;; The rest of this notebook:
-;; 1. **Setup** - dependencies and example datasets
-;; 2. **Inspiration** - AlgebraOfGraphics.jl background
-;; 3. **Design exploration** - problem/solution for compositional API
-;; 4. **Design overview** - key decisions and API preview
-;; 5. **How plots display** - auto-display behavior
-;; 6. **Implementation status** - what works, what's missing
-;; 7. **Rendering targets & delegation** - backend strategy
-;; 8. **Malli schemas** - reference material (can skim)
-;; 9. **Validation helpers** - error checking utilities
-;; 10. **API implementation** - operators, layer/plot-level properties
-;; 11. **Core implementation** - helper functions and rendering infrastructure
-;; 12. **Examples** - scatter, linear regression, histograms, grouping, faceting
-;; 13. **Multi-target rendering** - same spec across all backends
-;; 14. **Validation examples** - error messages in action
-;; 15. **Design discussions** - reflections on choices made
-;;
-;; **Note on IR:** The internal representation uses maps with `:=layers` keys,
-;; separating plot-level properties from layer specs. This enables clean composition
-;; and clear semantics for plot configuration.
-;;
-;; If you want to skip ahead to see it working, jump to "Basic Scatter Plots".
-
 ;; # Setup
 
 ;; ### ⚙️ Dependencies
@@ -426,6 +401,7 @@
 ;;   - Plot specs are maps with `:=layers` key containing vector of layer specs
 ;;   - Plot-level properties (`:=target`, `:=width`, `:=height`, scales) separate from layers
 ;;   - Enables clear distinction between plot configuration and layer data
+;;   - This separation enables clean composition and clear semantics for plot configuration
 ;;
 ;; **6. Multi-target rendering**
 ;;   - Same plot spec works across `:geom`, `:vl`, `:plotly` rendering targsts
@@ -457,6 +433,9 @@
 ;; **Auto-display:** Plot specs returned by `=*`, `=+`, and constructors automatically
 ;; display as plots in Kindly-compatible notebooks. Use `kind/pprint` to inspect
 ;; the raw plot spec map (with `:=layers` key) instead.
+;;
+;; **Want to see it in action?** Skip ahead to "Basic Scatter Plots" to see the API working,
+;; or continue reading for implementation details.
 
 ;; ### 📖 How Plots are Displayed
 ;;