docs: refactor & refine lifecycle API docs

[Josh-Cena]

Motivation

The lifecycle API doc is becoming more and more cluttered overtime, and the name is also somehow misleading since there are other non-lifecycle APIs. I wish to more formally introduce their usage.

Have you read the Contributing Guidelines on pull requests?

Yes

Test Plan

[netlify]

✔️ [V2]

🔨 Explore the source changes: b6bdfa9

🔍 Inspect the deploy log: https://app.netlify.com/sites/docusaurus-2/deploys/61bf22143afbea000786d6ff

😎 Browse the preview: https://deploy-preview-5918--docusaurus-2.netlify.app

[github-actions]

⚡️ Lighthouse report for the changes in this PR:

Category	Score
🟠 Performance	50
🟢 Accessibility	98
🟢 Best practices	100
🟢 SEO	100
🟢 PWA	95

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

[slorber]

👍 looks like a nice idea

Not so easy to categorize properly all these apis.

Maybe we should rename "lifecycle API" to just "plugin apis"?

We'll likely need a redirect in _redirects

[Josh-Cena]

Maybe we should rename "lifecycle API" to just "plugin apis"?

That's exactly what I plan to do:P https://deploy-preview-5918--docusaurus-2.netlify.app/docs/api/plugin-methods/

We'll likely need a redirect in _redirects

Since we already marked the section as WIP—won't that imply there can be any kind of breaking changes?

[github-actions]

Size Change: +5.38 kB (+1%)

Total Size: 658 kB

Filename	Size	Change
website/.docusaurus/globalData.json	39.3 kB	+1.53 kB (+4%)
website/build/assets/js/main.********.js	487 kB	+3.85 kB (+1%)

ℹ️ View Unchanged

Filename	Size
website/build/assets/css/styles.********.css	101 kB
website/build/index.html	29.6 kB

_{compressed-size-action}