Improve the notes on how this works