add a bit of variable documentation