added some notes and caveats