core: Tidy contributor onboarding, fix typos.

[GirlBossRush]

Details

This PR contains a subset of fixes discovered when progressing through the authentik contributor guide. Highlights include:

• Merging of disparate code spell dictionaries
• Optional Poetry env for hygiene commands (e.g. lint, build, etc)
• Fix for stale links, typos.

---

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	f69153f
🔍 Latest deploy log	https://app.netlify.com/sites/authentik-storybook/deploys/67899e6e68ada700088488be

[netlify]

✅ Deploy Preview for authentik-docs canceled.

Name	Link
🔨 Latest commit	f69153f
🔍 Latest deploy log	https://app.netlify.com/sites/authentik-docs/deploys/67899e6e68ada700088488c0

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 92.76%. Comparing base (84de155) to head (f69153f).
Report is 51 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main   #12700   +/-   ##
=======================================
  Coverage   92.75%   92.76%           
=======================================
  Files         769      769           
  Lines       38840    38898   +58     
=======================================
+ Hits        36026    36083   +57     
- Misses       2814     2815    +1     

Flag	Coverage Δ
e2e	48.58% <ø> (+<0.01%)	⬆️
integration	24.62% <ø> (-0.02%)	⬇️
unit	90.40% <ø> (+<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.

[rissson]

We usually assume devs will already be in a poetry shell, but I don't think this should matter anyway.

However, in CI (.github/workflows/ci-main.yml for instance), we do poetry run make test, so that should be updated as well.

[GirlBossRush]

Hi @rissson!

Thanks for reviewing my PR. I'm open to either approach, but it may help to keep the prefix.

When running make test without a Poetry shell activated, make doesn't know where to find the coverage command and emits an error without a hint at the solution.

❯ make test
coverage run manage.py test --keepdb authentik
make: coverage: No such file or directory
make: *** [test] Error 1

The virtual environment instructions appear in the full-stack setup docs, but my concern is that contributors who start with the front-end or docs environments might miss the Python requirements when switching contexts.

Since ci-main.yml uses the poetry prefix consistently, would it make sense to keep it for now? We could look at removing it from both places as a separate task if you think that would be valuable.

Thanks for your feedback!