That's a good point - a could top level comment could be: "We switched from x to y. It was important because it justified rewriting the thing, which improved p

That's a good point - a could top level comment could be: "We switched from x to y. It was important because it justified rewriting the thing, which improved performance. Would have loved to rewrite it in x, but support just wasn't there."