# gotchas -- known foot-guns in this repo

Things that surprised us at least once. Organized by where the
surprise lives. Each entry: **symptom**, **cause**, **workaround**.

<!-- Grow organically. Below is the example shape. -->

## <Area / Tool>

### <Short symptom>

**Symptom:** <what you observe>.
**Cause:** <what is actually happening>.
**Workaround:** <how to deal with it, or pointer to fix>.
