adding some minor fixes to main page of docs

[keighrim]

Another general documentation updates/improvements, along with other fixes for #348.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 73.76%. Comparing base (503abe2) to head (96a8b2e).
⚠️ Report is 17 commits behind head on develop.

Additional details and impacted files

@@ Coverage Diff @@## develop #361 +/- ##
===========================================
+ Coverage 66.58% 73.76% +7.18% 
===========================================
Files 22 22 Lines 2846 3023 +177 ===========================================
+ Hits 1895 2230 +335 + Misses 951 793 -158 

Flag	Coverage Δ
unittests	73.76% <ø> (+7.18%)	⬆️

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.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.