Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix(docs): move provider docs to source code #7275

Merged
merged 12 commits into from
Apr 24, 2023

Conversation

ubbe-xyz
Copy link
Collaborator

☕️ Reasoning

Move the provider's documentation to the source code.

Currently, I only documented like ~4 providers, I need to finish once I'm back from holidays 🏖️ , like in ~10 days.

The proposed structure for each provider page is as follows:

  • Header
  • Setup
  • Resources
  • Help

image

The idea is that they look similar to the adapter pages, and the structure and content in all of them are similar, so if the user reads one, they can then read the others easily.

⚠️ To address

We need to remove these:

image

image

From the pre-generated code. They make the pages look pretty messy and confusing for the user.

We also need to better explain the profile() callback and why documenting the properties of the user object it receives is helpful when overridden.

image

🧢 Checklist

  • Documentation
  • Tests
  • Ready to be merged

🎫 Affected issues

None

Fixes: INSERT_ISSUE_LINK_HERE

📌 Resources

@ubbe-xyz ubbe-xyz added documentation Relates to documentation providers labels Apr 16, 2023
@vercel
Copy link

vercel bot commented Apr 16, 2023

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
auth-docs ✅ Ready (Inspect) Visit Preview 💬 Add feedback Apr 24, 2023 8:19am
2 Ignored Deployments
Name Status Preview Comments Updated (UTC)
auth-docs-nextra ⬜️ Ignored (Inspect) Apr 24, 2023 8:19am
next-auth-docs ⬜️ Ignored (Inspect) Apr 24, 2023 8:19am

@github-actions github-actions bot added core Refers to `@auth/core` and removed documentation Relates to documentation labels Apr 16, 2023
@ThangHuuVu ThangHuuVu requested a review from ndom91 as a code owner April 23, 2023 08:52
@github-actions github-actions bot added the legacy Refers to `next-auth` v4. Minimal maintenance. label Apr 23, 2023
@github-actions github-actions bot removed the legacy Refers to `next-auth` v4. Minimal maintenance. label Apr 24, 2023
@balazsorban44 balazsorban44 changed the title docs(providers): move to source code fix(docs): move provider docs to source code Apr 24, 2023
id: "faceit",
name: "FACEIT",
type: "oauth",
authorization: "https://accounts.faceit.com/accounts?redirect_popup=true",

Check failure

Code scanning / CodeQL

Hard-coded credentials

The hard-coded value "https://accounts.faceit.com/accounts?redirect_popup=true" is used as [authorization header](1).
@balazsorban44 balazsorban44 merged commit 443bfd6 into main Apr 24, 2023
1 check passed
@balazsorban44 balazsorban44 deleted the docs/providers-to-source-code branch April 24, 2023 08:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
core Refers to `@auth/core` providers
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants