updated documentation with new variable names and nested lists