Fixed doc issues around links and nested formatting

[jonathan343]

This PR addresses issues with botocore docs which include:

• Missing or necessary white space which causes links to render incorrectly
• Nested formatting not being supported by Sphinx.

Examples:

• https://botocore.amazonaws.com/v1/documentation/api/latest/reference/services/kms.html#:~:text=https%3A//docs.aws.amazon.com/kms/latest/developerguide/%60.
• https://botocore.amazonaws.com/v1/documentation/api/latest/reference/services/iam.html#:~:text=parameter%20in%20the-,%60%60%20GetOrganizationsAccessReport%20%60%60,-operation%20to%20check

[codecov-commenter]

Codecov Report

Base: 93.49% // Head: 93.45% // Decreases project coverage by -0.04% ⚠️

Coverage data is based on head (253442b) compared to base (2df5c5b).
Patch coverage: 100.00% of modified lines in pull request are covered.

Additional details and impacted files

@@             Coverage Diff             @@
##           develop    #2817      +/-   ##
===========================================
- Coverage    93.49%   93.45%   -0.05%     
===========================================
  Files           63       63              
  Lines        13346    13381      +35     
===========================================
+ Hits         12478    12505      +27     
- Misses         868      876       +8     

Impacted Files	Coverage Δ
botocore/docs/bcdoc/docstringparser.py	99.25% <100.00%> (+0.07%)	⬆️
botocore/docs/bcdoc/restdoc.py	96.42% <100.00%> (ø)
botocore/docs/bcdoc/style.py	95.46% <100.00%> (-0.74%)	⬇️
botocore/compat.py	91.33% <0.00%> (-1.34%)	⬇️
botocore/httpsession.py	91.40% <0.00%> (-0.40%)	⬇️
botocore/utils.py	79.07% <0.00%> (-0.13%)	⬇️
botocore/endpoint_provider.py	99.35% <0.00%> (-0.01%)	⬇️
botocore/handlers.py	96.44% <0.00%> (+<0.01%)	⬆️
botocore/client.py	97.84% <0.00%> (+0.01%)	⬆️

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

☔ View full report at Codecov.
📢 Do you have feedback about the report comment? Let us know in this issue.

[jonemo]

Looks good, but I had a few comments where the code seems unnecessarily complex.

[jonemo]

🚢 🇮🇹