refactor(content-docs): deduplicate types, JSDoc for some APIs

[Josh-Cena]

Breaking change

This should be mostly internal, but if you enhanced the doc plugin or monkey-patched it in a 3rd party plugin and relied on internal data structures like version metadata, their shapes may have changed. Most notably, versionMetadata.version* have the version prefix stripped except for versionName, so versionBadge becomes badge, versionPath -> path, etc. Swizzled themes or client APIs are not affected.

Motivation

The great type deduplication, because we want to re-use JSDoc😞

Have you read the Contributing Guidelines on pull requests?

Yes

Test Plan

Build

[netlify]

✅ [V2]

Name	Link
🔨 Latest commit	8524966
🔍 Latest deploy log	https://app.netlify.com/sites/docusaurus-2/deploys/623febcbbe30e6000950781a
😎 Deploy Preview	https://deploy-preview-7027--docusaurus-2.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site settings.

[github-actions]

⚡️ Lighthouse report for the changes in this PR:

Category	Score
🔴 Performance	43
🟢 Accessibility	100
🟢 Best practices	92
🟢 SEO	100
🟢 PWA	90

Lighthouse ran on https://deploy-preview-7027--docusaurus-2.netlify.app/

[github-actions]

Size Change: 0 B

Total Size: 806 kB

ℹ️ View Unchanged

Filename	Size
website/.docusaurus/globalData.json	49.9 kB
website/build/assets/css/styles.********.css	105 kB
website/build/assets/js/main.********.js	613 kB
website/build/index.html	38.4 kB

_{compressed-size-action}