added some documentation
specify attributes to use for lookup dict