nextauthjs / nextauthjs/next-auth
Contradictory docs about automatic account linking
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 28.4k
- Forks
- 4k
- PR merge metrics
- No merged PRs in 30d
Description
What is the improvement or update you wish to see?
As per this section, accounts from different oauth providers with the same email are automatically linked, however here it's mentioned that's not the case.
Is there any context that might help us understand?
It would be less confusing if the behavior around account linking is clearly documented, alongwith the reasoning behind the behavior as well as steps to alter the behavior.
Does the docs page already exist? Please link to it.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Compare the account-linking statements in docs/pages/getting-started/authentication.mdx and docs/pages/concepts/index.mdx, then verify which behavior and configuration guidance are intended. Done means the documentation consistently explains automatic linking, its rationale, and how to alter the behavior.
Written by the indexing model from the issue text.
Assessment
- Domain
- authentication, documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100