document variables a little