compiler notes for the README