[AWARE] Update PeerHandle doc to reflect good practice on usage

Update PeerHandle doc to relfect that while can be compared and hashed,
good practice will use an app level identifier.

Bug: 68931709
Test: 'make update-api' and reviewed generated doc
Change-Id: If6725e8854976d482ca18429a9b5352cff0baf93
1 file changed