Incompatible and interesting new APIs can be found in the documentation in two ways:
org.eclipse.platform.doc.isv
porting/eclipse_3_4_porting_guide.html