website/docs: style guide & integration template: revamp

[dominic-r]

What?

This PR revamps the style guide and provides an updated version of the integration template in lieu of having an approximate non-written-with-new-app-creation-method template. I also took the time to highlight some things I noticed while reviewing PRs and some things I questioned myself about.

A good chunk of this PR is reformatting and rewriting existing information. Rest assured... new stuff was added.

I wanna try to get this done before I do more batch PRs, just to give myself (and others who contribute to integrations during this transition period) a stable base.

Hi @tanberry :) Have fun! I know you mentioned that other style guide, but I feel like integrating parts of it gradually would be more beneficial

Details

REPLACE ME

---

Checklist

• Local tests pass (ak test authentik/)
• The code has been formatted (make lint-fix)

If an API change has been made

• The API schema has been updated (make gen-build)

If changes to the frontend have been made

• The code has been formatted (make web)

If applicable

• The documentation has been updated
• The documentation has been formatted (make website)

[netlify]

✅ Deploy Preview for authentik-storybook canceled.

Name	Link
🔨 Latest commit	132282a
🔍 Latest deploy log	https://app.netlify.com/sites/authentik-storybook/deploys/67d4a516b2e16a0008938bf0

[netlify]

✅ Deploy Preview for authentik-docs ready!

Name	Link
🔨 Latest commit	132282a
🔍 Latest deploy log	https://app.netlify.com/sites/authentik-docs/deploys/67d4a5168487110008a4b83a
😎 Deploy Preview	https://deploy-preview-12929--authentik-docs.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 configuration.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 92.73%. Comparing base (876fecc) to head (132282a).
Report is 20 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #12929      +/-   ##
==========================================
- Coverage   92.76%   92.73%   -0.03%     
==========================================
  Files         794      794              
  Lines       40419    40425       +6     
==========================================
- Hits        37494    37489       -5     
- Misses       2925     2936      +11     

Flag	Coverage Δ
e2e	47.99% <ø> (-0.01%)	⬇️
integration	24.31% <ø> (+0.23%)	⬆️
unit	90.50% <ø> (-0.01%)	⬇️

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

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[tanberry]

Yay, looks great, thank you @dominic-r. Lets wait until 2025.2 goes out before we merge (since the UI will not change until then), but it is ready to merge on release day.

[dominic-r]

Depends on #13179