Add documentation to PeerLogicValidation interface and related functions

Summary: This is a backport of Core PR12603

Test Plan:

make check

Reviewers: #bitcoin_abc, Fabien

Reviewed By: #bitcoin_abc, Fabien

Differential Revision: https://reviews.bitcoinabc.org/D4052