I think this is a nice "advanced example" of how to create an equivalency, and should probably go into the `Writing new equivalencies` section, along with any changes that @keflavich thinks would make that section easier to follow.  Here, I would just show how to use the (soon to be) built-in doppler equivalency function, along with the math.