> ## Documentation Index
> Fetch the complete documentation index at: https://aspect.build/llms.txt
> Use this file to discover all available pages before exploring further.

# Gradient Ascent

> Apply BazelCon's gradient-ascent strategy during a Bazel migration to maximize benefits and defer risks without leaving developer experience worse off.

A migration can't leave a developer experience in a bad state before improving it.

Alex and Greg explain this in a BazelCon talk:

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/UwuRGpVpmbo?t=398" title="YouTube video player" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

As explained in that talk, we want to maximize the benefits of Bazel, while deferring costs and known risks. We have to keep making improvements.

Don't say "we'll just leave a TODO here to come back and fix the performance regression".
That TODO will be there longer than you think, maybe forever.
In the meantime dissatisfaction might cause escalation to decision makers who de-fund the migration work.

This is related to the YouTube results for "changing a tire while driving".
Even though a big migration is underway, it's critical to the business that it be non-disruptive.
