Don't mean to beat a dead or dying horse, but it might be closer to the intent--which seems to be a version of "be careful or you'll royally mess up your code" or "be vigilant"--to say "... , you'll need to watch for compatibility problems and resolve them as they arise in your code base." (Sidebar: would we consider contractions, like "you'll" here, too informal? "We've" is used in some places in the documentation. As minor as a contraction edit can be, it seems to be more in keeping with the documentation's overall tone.)