doc: improve https module documentation
Checklist
-
documentation is changed or added -
commit message follows commit guidelines
Affected core subsystem(s)
- doc
Description of change
This commit makes the following changes:
- Reduces redundancy
- Highlights class inheritance
- Adds function descriptions
- Uses consistent language and formatting in text and consistent coding style in examples