...

This should be improved. New output of improved -- re-balance algorithm (–generate) algorithm should suite following requirements:

...

• What impact (if any) will there be on existing users?

--generate runs the old logic and --re-balance implements the new logic

• If we are changing behavior how will we phase out the older behavior?

...

• When will we remove the existing behavior?

...

Rejected Alternatives

If there are alternative ways of accomplishing the same thing, what were they? The purpose of this section is to motivate why the design is the way it is and not some other way.