The design was kindly contibuted by @benjamin of Atlassian. I think it’s a giant improvement over my original attempt. Many thanks! (Note that on a few points, I adjusted his original design, so if something is awful, that’s likely my fault, not Benjamin’s.)
I still didn’t get around to writing of more documentation and copy, so the text is largely still the old stuff. That’s going to be one of the next priorities.