[docs] Full edit review of wording and references.

[jd-foster]

Update wording and references alongside general fixes and cleaning up in documentation.

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 51.81%. Comparing base (40caf9c) to head (6ba06dd).
⚠️ Report is 18 commits behind head on master.

Additional details and impacted files

@@             Coverage Diff             @@
##           master     #511       +/-   ##
===========================================
+ Coverage   28.67%   51.81%   +23.13%     
===========================================
  Files           8        8               
  Lines         265      276       +11     
===========================================
+ Hits           76      143       +67     
+ Misses        189      133       -56     

Flag	Coverage Δ
unittests	?

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.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[jd-foster]

@BeastyBlacksmith
Hi Simon, this is a pretty large PR but it is all documentation edits, corrections and explanation, but no code changes to the package. If you would have a chance to look over it would be appreciated.

[BeastyBlacksmith]

Looks good to me, reads a lot better. Thanks for updating !