addressing PR comments; added specs