improvements to the backward compatibility section

break up large section into subsections for each case so it's easier to follow