Improvements to tls API documentation, batch 1

Checklist

• make -j8 test (UNIX), or vcbuild test nosign (Windows) passes
• tests and/or benchmarks are included
• documentation is changed or added
• commit message follows commit guidelines

Affected core subsystem(s)

doc,tls

Description of change

Improvements to tls API documentation.