playbook.crastinating.pro
Tag

platform

2 playbooks on platform.

Lifecycle4 criteria

Deprecating an internal API

One-way

Killing a piece of internal surface area — when, how loud, and what the deadline actually means.

Default pick
Pick the deadline first, then work backwards. A deprecation without a date is a backlog item; a deprecation with a date is a project. Default cadence: announce → 8 weeks soft warnings → 4 weeks hard warnings → cut.
4 min read
  • deprecation
  • api design
  • lifecycle
Scope4 criteria

Migration scope: incremental, big-bang, or strangler

One-way

Three honest shapes for any migration. The wrong shape is the most common failure mode.

Default pick
Strangler-fig migration. Stand up the new thing alongside the old, route traffic by shape, and shrink the old one's footprint until it has zero callers. Pick a real end-of-life date the day you start.