document "How it works", light first pass