notes on how the responses might be refactored to be a little more useful