better documentation for signature verifications