Migration

What a provider's notice period means for your migration

A provider's notice period, the window of time between an announced deprecation or shutdown and the date it actually takes effect, is one of the most valuable and most commonly wasted resources in a forced migration. It exists specifically to give integrating teams time to react in an orderly way, but a surprising number of migrations still end up rushed in the final days regardless, because the early weeks of a notice period tend to get spent on other priorities before the deadline feels real.

The core mistake is treating a distant deadline as equivalent to no deadline at all. A notice period of several months looks, at the start, like plenty of time to plan a migration whenever it becomes convenient. It rarely stays convenient for long, since other work keeps arriving on its own schedule, and a deadline that felt comfortably far away has a way of becoming urgent all at once.

A better way to use a notice period is to work backward from the actual cutoff date and build in the review and testing time a migration genuinely needs, rather than starting from "we have plenty of time" and letting the schedule fill up with other things. A reasonable breakdown for a notice period of several months might look like:

  1. The first quarter of the period: assess the full scope of what depends on the deprecated service, inventory every call site, and choose a replacement
  2. The middle half: build and test the replacement integration, including error handling, quota behavior, and edge cases specific to your own data
  3. The final quarter: run both providers side by side if possible, watch for discrepancies, and complete the cutover with real time left over as a buffer, not right against the deadline

This structure treats the last portion of the notice period as a buffer for the inevitable delay, rather than the period in which the actual work happens, which is where rushed migrations tend to go wrong.

If a compatibility host exists for the provider being deprecated, that changes how much of the middle phase, building and testing the replacement integration, is actually needed, since a matching compatibility host means the response parsing code your application already has does not need to be rewritten at all, only pointed at a new host with new credentials. My Geocode's 17 compatibility hosts, listed at /compatibility/, cover this exact scenario for a meaningful range of providers, and checking that list early in a notice period, right at the assessment stage, is worth doing before committing engineering time to a from-scratch rewrite of parsing logic that a compatibility host might make unnecessary.

Whatever the actual timeline turns out to be, the discipline that matters most is starting the assessment phase the day a notice arrives, not the week the deadline starts to feel close.