some notes in the README about what's up