vars with added documentation, need to revisit