docs: remove old docs folder and replace with new one

[mowies]

Description

This PR move the docs-new to the docs folder and deletes the old docs folder.
It also fixes all other occurrences of docs-new and changes them to docs.

Notes

Please review commit by commit to reduce confusion with seemingly moved files!

Fixes #2774

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (a1330ee) 85.75% compared to head (792f620) 85.72%.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2816      +/-   ##
==========================================
- Coverage   85.75%   85.72%   -0.03%     
==========================================
  Files         160      160              
  Lines       10164    10164              
==========================================
- Hits         8716     8713       -3     
- Misses       1169     1171       +2     
- Partials      279      280       +1     

see 1 file with indirect coverage changes

Flag	Coverage Δ
certificate-operator	67.42% <ø> (ø)
component-tests	56.36% <ø> (-0.77%)	⬇️
lifecycle-operator	84.72% <ø> (ø)
metrics-operator	87.65% <ø> (ø)
scheduler	36.53% <ø> (ø)

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

[sonarqubecloud]

Quality Gate failed

Failed conditions

C Reliability Rating on New Code (required ≥ A)

See analysis details on SonarCloud

Catch issues before they fail your Quality Gate with our IDE extension SonarLint

[StackScribe]

So what is the plan vis-a-vis this PR and #2705 ? I would hope that we would merge that with the docs-new references as well as any viable open docs PRs before we merge this, then will need to make another pass at the contrib guide to replace "docs-new" with "docs" but please confirm.

[mowies]

@StackScribe if we merge this one first, I can go ahead and fix the contrib guide in my other PR directly :)

[StackScribe]

I would prefer that we go ahead and merge the other PR and then do a separate PR for the docs-new -> docs change -- and I could do that. But please, let's try to get as many PRs merged as possible before we merge this one! We will probably have some that aren't ready and will have to be modified later but let's minimize that effort as much as possible!

[mowies]

superseded by #2825