Ok, I clarified it some, although it's still dense. I also added a TODO for the paragraph above to consider stealing code from here to give better feedback Since this is already such an epic PR I didn't have the heart to go add in refactoring of code that I don't know anything about.