rangefeed: comment cleanup, re-arrange functions

I took a large pass through the comments, trying to make them a bit more
concise and I re-arranged the function order a bit to make the file
easier to read straight through.

Epic: none
Release note: None

Author: stevendanna