add some notes on recent fixes