updated doc

besides doc for the args passed in, I think it would be nice to have one sentences that describes this function a bit more (e.g. what is a region - what is its ID)