A few comments about what this function is for would be nice and how the data structure that gets returned is meant to be used would be nice.