pepper the ported verification logic with comments and thoughts...