[Docs] Polish the docs

[martintmk]

Details on the issue fix or feature implementation

Run the new sections through Chat GPT 4 model to polish them off.

Contributes to #1558

Confirm the following

• I started this PR by branching from the head of the default branch
• I have targeted the PR to merge into the default branch
• I have included unit tests for the issue/feature
• I have successfully run a local build

[martintmk]

cc @peter-csala

[codecov]

Codecov Report

Patch and project coverage have no change.

Comparison is base (8241fc4) 84.63% compared to head (52e2c63) 84.63%.
Report is 10 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1619   +/-   ##
=======================================
  Coverage   84.63%   84.63%           
=======================================
  Files         306      306           
  Lines        6820     6820           
  Branches     1044     1044           
=======================================
  Hits         5772     5772           
  Misses        839      839           
  Partials      209      209           

Flag	Coverage Δ
linux	?
macos	84.63% <ø> (ø)
windows	84.63% <ø> (?)

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.