(PE-5344) Documentation updates for extensions and some cosmetic updates

This commit includes some additional documentation in the `README.md`
around the inputs and outputs for the Basic Constraints and Authority Key
Identifier extensions.

This commit also addresses some pull request comments on cosmetic issues
in the source code.