eng doc

docs/user/lights/README.md

@@ -0,0 +1,16 @@
+# Lights — user documentation
+
+The **lighting side** of the scene: the light model, shadows, and emissive materials.
+
+| Page | Topic |
+|------|-------|
+| [Lights](lights.md) | Scene-global lights (directional/point/spot/ambient), `MAX_LIGHTS`, packed indices |
+| [Shadows](shadows.md) | Shadow mapping: picking the casting light, the packed-index pitfall, tuning |
+| [Emissive + Exposure](emissive-exposure.md) | Emissive materials (HDR glow) and runtime exposure |
+
+Example folder: [`lib/examples/lights/`](../../../lib/examples/lights/README.md)
+(`shadow`, `shadow_test`, `spot_test`, `emissive`).
+
+## Links
+
+- [User documentation index](../README.md) · [Quickstart](../quickstart.md) · [Examples](../examples.md)