Cleanup ota reference manual

[kprosise]

Grammar and style changes made.
Updates to content may be required.

QA: Ran linter in editor.
Checked rendered output in browser, no rendering issues spotted. Linkcheck encountering issues not believed to be associated with any changes made in this commit.

This commit addresses FFTK-2792
This commit applies to FFTK-2730
This commit applies to FFTK-2732
This commit applies to FFTK-2731
This commit applies to FFTK-1702
This commit applies to FFTK-988

Readiness

• Merge (pending reviews)
• Merge after date or event
• Draft

Overview

Why merge this PR? What does it solve?

Checklist

Optional. Add a 'x' to steps taken.
You can fill this out after opening the PR. "Did I..."

• Run spelling and grammar check, preferably with linter.
• Avoid changing any header associated with a link/reference.
• Step through instructions (or ask someone to do so).
• Review for wordiness
• Match tone and style of page/section.
• Run make linkcheck.
• View HTML in a browser to check rendering.
• Use semantic newlines.
• follow best practices for commits.
  • Descriptive title written in the imperative.
  • Include brief overview of QA steps taken.
  • Mention any related issues numbers.
  • End message with sign off/DCO line (-s, --signoff).
  • Sign commit with your gpg key (-S, --gpg-sign).
  • Squash commits if needed.
• Request PR review by a technical writer and at least one peer.

Comments

Any thing else that a maintainer/reviewer should know.
This could include potential issues, rational for approach, etc.

[doanac]

Docs for fc7fec1 are browsable at: https://ci.foundries.io/projects/fio-docs/builds/2506/docs/artifacts/html/index.html

[vkhoroz]

@kprosise I think you're making a great improvement to our docs with this PR.

However, closer to the end I've completely lost attention.
It would be much easier to grasp what's really changed if this PR is split into individual commits, each targetting a specific problem you tried to fix.
For example, the pure sentence split or a global replacement of target -> Target, would look the best as separate commits.

I know, it is way too late, and you did a lot of great job, so I don't want to force you redoing this.
We may try pursuing this PR as is.
It is just something to consider for the future.

[kprosise]

Adding suggestions...

[doanac]

Docs for 636e9d8 are browsable at: https://ci.foundries.io/projects/fio-docs/builds/2508/docs/artifacts/html/index.html

[doanac]

Docs for 5bf6928 are browsable at: https://ci.foundries.io/projects/fio-docs/builds/2509/docs/artifacts/html/index.html

[doanac]

Docs for 70fbcb1 are browsable at: https://ci.foundries.io/projects/fio-docs/builds/2510/docs/artifacts/html/index.html

[doanac]

Docs for 17e7c19 are browsable at: https://ci.foundries.io/projects/fio-docs/builds/2511/docs/artifacts/html/index.html

[doanac]

Docs for 9ad4fe8 are browsable at: https://ci.foundries.io/projects/fio-docs/builds/2512/docs/artifacts/html/index.html

[doanac]

Docs for 19e771a are browsable at: https://ci.foundries.io/projects/fio-docs/builds/2513/docs/artifacts/html/index.html

[doanac]

Docs for 1d44971 are browsable at: https://ci.foundries.io/projects/fio-docs/builds/2514/docs/artifacts/html/index.html

[doanac]

Docs for 8bd4898 are browsable at: https://ci.foundries.io/projects/fio-docs/builds/2519/docs/artifacts/html/index.html

[doanac]

Docs for 42c8519 are browsable at: https://ci.foundries.io/projects/fio-docs/builds/2524/docs/artifacts/html/index.html