Modernize docs

[jakob-keller]

Description of Change

Closes #1161

Assumptions

None

Checklist for All Submissions

• I have added change info to CHANGES.rst
• If this is resolving an issue (needed so future developers can determine if change is still necessary and under what conditions) (can be provided via link to issue with these details):
  • Detailed description of issue
  • Alternative methods considered (if any)
  • How issue is being resolved
  • How issue can be reproduced
• If this is providing a new feature (can be provided via link to issue with these details):
  • Detailed description of new feature
  • Why needed
  • Alternatives methods considered (if any)

Checklist when updating botocore and/or aiohttp versions

• I have read and followed CONTRIBUTING.rst
• I have updated test_patches.py where/if appropriate (also check if no changes necessary)
• I have ensured that the awscli/boto3 versions match the updated botocore version

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 86.93%. Comparing base (d80e20d) to head (e6b1a3e).
Report is 71 commits behind head on master.

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #1165   +/-   ##
=======================================
  Coverage   86.93%   86.93%           
=======================================
  Files          64       64           
  Lines        5978     5978           
=======================================
  Hits         5197     5197           
  Misses        781      781           

Flag	Coverage Δ
unittests	86.93% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

---

🚨 Try these New Features:

• Flaky Tests Detection - Detect and resolve failed and flaky tests

[webknjaz]

I think this, is good assuming that consolidating sphinx runs would be done separately.