Docs: major update

[emmercm]

Fixes: #2161

RE: #1835

[github-actions]

🧪 Package testing instructions

This pull request can be tested locally with the following command:

npx --yes "https://pkg.pr.new/igir@8d073d7" [commands..] [options]

Comment generated by the Node.js Test Package workflow.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.67%. Comparing base (72871cf) to head (8d073d7).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #2131   +/-   ##
=======================================
  Coverage   90.66%   90.67%           
=======================================
  Files         161      161           
  Lines       10413    10413           
  Branches     2547     2543    -4     
=======================================
+ Hits         9441     9442    +1     
+ Misses        863      862    -1     
  Partials      109      109           

☔ 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.