would like to make this more readable.  could do as hash with readable keys or add inline comments?