fixed docs around values lists while i'm in here