# Example learning routes

Every `.tex` file here is a complete document. Compile from the package root:

```sh
pdflatex -output-directory=tmp examples/mechanics-wedge-spring-pulley.tex
```

| Start with | What it teaches |
| --- | --- |
| `mechanics-wedge-spring-pulley.tex` | Defaults, contact anchors, spring, native pulley connection |
| `debug-explorer.tex` | Reference card and selected anchor families inside TikZ |
| `debug-scoped.tex` | Inherited debug settings and local false overrides |
| `wedge-contact-anchors.tex` | The same attachment method for all wedge orientations |
| `mechanics-primitives.tex` | Supports, rod, disk, force, velocity, torque, pendulum |
| `short-names-platform-pulley.tex` | Minimal surface and pulley composition |
| `short-names-wedge-variants.tex` | Wedge angle, height and right-angle modes |
| `wedge-geometry-values.tex` | Read resolved angles and dimensions from a named wedge |
| `percentage-anchors-beginner.tex` | Named edges and percentage directions |
| `coordinate-projection.tex` | Horizontal/vertical connections using `|-` and `-|` |
| `surface-flat-walls.tex` | Ground, ceiling and vertical walls |
| `surface-platforms.tex` | Basic platform shapes |
| `surface-platform-variants.tex` | Bent platform layouts |
| `surface-platform-key-variants.tex` | Platform options and their effects |
| `surface-bent-platform.tex` | A complete bent platform |
| `surface-numeric-anchors.tex` | Edge-family gallery |
| `surface-wedge.tex` | Wedge geometry |
| `ramp-straight-system.tex` | Wall, floor and sharp incline |
| `ramp-curved-system.tex` | Tangent placement on a circular ramp |
| `ramps-gallery.tex` | Ramp variations |
| `mechanics-spring-block.tex` | Basic spring connection |
| `mechanics-block-pulley.tex` | Basic pulley system |
| `mechanics-pulley-flat-plane.tex` | Horizontal plane and hanging mass |
| `mechanics-pulley-bent-platform.tex` | Pulley on a bent platform |
| `mechanics-pulley-two-masses.tex` | Two hanging masses |
| `mechanics-pulley-string-variants.tex` | Over, under and explicit string routes |
| `optics-components.tex` | All optical components |
| `optics-mirrors.tex` | Mirror shapes |
| `optics-ray-composition.tex` | Rays composed from optical anchors |
| `optics-complete-ray-diagrams.tex` | Complete diagrams with stated optical assumptions |
| `debug-demo.tex`, `debug-anchor.tex` | Original debug examples |

The [feature reference](../docs/reference.md) lists keys and anchors for each object.
