better comments for explanation; I'll add an example to the README soon