[WFLY-2527] Add some better documentation of what the test is doing

Alexey and I just had a long chat where we were figuring out what this test was doing; best to write it down as it's subtle.