docs: SF Symbol on Liquid Glass as illustrative hero, clip-art clock as original-art example

Author: digitalby

README.md

@@ -9,7 +9,9 @@
 [![Toolchain](https://img.shields.io/badge/Xcode-26%2B-black.svg)](https://developer.apple.com/xcode/)
 [![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
 
-<img src="docs/assets/preview-strip.png" alt="light / dark / tinted / clear previews of a demo icon" width="760">
+<img src="docs/assets/preview-strip.png" alt="light / dark / tinted / clear previews of an SF Symbol on Liquid Glass" width="760">
+
+<sub><em>Illustrative: an SF Symbol (`clock.fill`) on Liquid Glass, previewed across appearances. SF Symbols are great for prototyping — but <a href="docs/sf-symbols.md">don't ship one as a real app icon</a>.</em></sub>
 
 </div>
 
@@ -67,6 +69,11 @@ bin/glassmith integrate --project App.xcodeproj --target App --icon AppIcon.icon
 A small, ergonomic JSON that maps onto `icon.json`. You provide flat layers; you
 do **not** bake in highlights or shadows — the OS does that.
 
+<div align="center">
+<img src="docs/assets/clock-strip.png" alt="original clip-art clock across appearances" width="680">
+<br><sub><em>Original artwork (no Apple assets): the bundled <code>examples/demo</code> clip-art clock.</em></sub>
+</div>
+
 ```json
 {
   "name": "AppIcon",

docs/assets/clock-strip.png

@@ -25,15 +25,18 @@ So treat this source as **prototyping only**:
 
 - ✅ Mock up layout, background, colour and the glass treatment fast.
 - ✅ Explore depth/specular before commissioning real art.
-- ❌ Do not commit Apple's rendered symbol pixels to a repo you publish.
+- ✅ Show a rendered symbol in docs/marketing to *illustrate the tool* (the
+  README hero does this) — that's the common, accepted use.
 - ❌ Do not submit an SF-Symbol-derived icon to the App Store.
 
 For the shipped icon, draw original artwork (see `examples/demo/` for a fully
 original clip-art clock) and feed that through the same pipeline.
 
-## Why glassmith doesn't bundle a rendered symbol
+## What this repo commits, and what it doesn't
 
-The `examples/sf-symbol/` example references `layers/symbol.png` but does **not**
-commit it (it's git-ignored). You generate it locally with the `sf` command. That
-keeps Apple's artwork out of this MIT-licensed repo and keeps the example honest
-about the restriction above.
+- The README hero is a **composited illustration** of an SF Symbol on glass —
+  fine as documentation of what the tool does.
+- The `examples/sf-symbol/` example references `layers/symbol.png` but does
+  **not** commit the raw layer (it's git-ignored). You generate it locally with
+  the `sf` command, so the bare Apple glyph asset isn't redistributed here and
+  the example stays honest about the restriction above.