document what's going on in this example