documented first-run gotchas