updated README, docs note