update compatibility notes and test harness