more docs, incl. showing how the variables work