consistency/format in tests

[heckj]

iterate through tests referenced from the references.adoc

• verify test name matches what the test is doing
• add explanatory comments of what the test is doing
• comment around XCTFail for what it's doing
• add patterns-testing references to tests to explain what/how they're working