docs: overhauled docs

[JoshuaKGoldberg]

PR Checklist

• Addresses an existing open issue: fixes 📝 Documentation: Rework README.md and docs/ #856
• That issue was marked as status: accepting prs
• Steps in CONTRIBUTING.md were taken

Overview

Streamlines the flow of how devs will likely read through the docs. Most notably, adds a big docs/Tooling.md with a table explicitly describing what all the tooling pieces are.

[codecov]

Codecov Report

Merging #895 (195dcbf) into main (4486186) will increase coverage by 11.34%.
Report is 2 commits behind head on main.
The diff coverage is 94.16%.

@@             Coverage Diff             @@
##             main     #895       +/-   ##
===========================================
+ Coverage   82.19%   93.54%   +11.34%     
===========================================
  Files          84       90        +6     
  Lines        4612     4726      +114     
  Branches      214      374      +160     
===========================================
+ Hits         3791     4421      +630     
+ Misses        817      304      -513     
+ Partials        4        1        -3     

Flag	Coverage Δ
create	72.03% <94.16%> (+0.06%)	⬆️
initialize	37.18% <94.16%> (+0.11%)	⬆️
migrate	70.78% <94.16%> (+0.02%)	⬆️
unit	67.25% <94.16%> (?)

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

Files	Coverage Δ
src/shared/options/exclusionDescriptions.ts	100.00% <100.00%> (ø)
src/shared/options/augmentOptionsWithExcludes.ts	43.58% <30.00%> (-17.19%)	⬇️

... and 46 files with indirect coverage changes

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[github-actions]

🎉 This is included in version v1.32.0 🎉

The release is available on:

• GitHub releases
• npm package (@latest dist-tag)

Cheers! 📦🚀