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

docs(providers): update providers documentation #1900

Merged
merged 10 commits into from May 2, 2021

Conversation

ubbe-xyz
Copy link
Collaborator

Reasoning 💡

We realised that the documentation for the different available provider options was out of date.

I took the opportunity to re-work a bit the Providers page in our docs to delineate better the 3 ways to sign-in

  • OAuth
  • email
  • credentials

and the steps and options for each. When listing the options for each type of provider, it took our types as the source of truth, as agreed with @balazsorban44. I also added emojis 🙈

Screenshot 2021-04-30 at 18 07 23

Checklist 🧢

  • Documentation
  • Tests
  • Ready to be merged

Affected issues 🎟

#1792

- delineate clearly the 3 provider types (oauth, email, credentials)
- make each section structure consistent
- update the option list for every provider type
- use emojis
@vercel
Copy link

vercel bot commented Apr 30, 2021

This pull request is being automatically deployed with Vercel (learn more).
To see the status of your deployment, click below or on the icon next to each commit.

🔍 Inspect: https://vercel.com/nextauthjs/next-auth/9qBJB554xsoLTTR6WdvN2xt34RQW
✅ Preview: https://next-auth-git-docs-1792-providers-params-table-nextauthjs.vercel.app

@github-actions github-actions bot added documentation Relates to documentation providers labels Apr 30, 2021
Copy link
Member

@balazsorban44 balazsorban44 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

https://next-auth-git-docs-1792-providers-params-table-nextauthjs.vercel.app/configuration/providers#-adding-a-new-provider

could you mention adding the type in types/providers to be able to see it in TS as step 3? (or we could figure out how to generate that type out of the src/providers folder, as we generate the index.js file as well)

@vercel vercel bot temporarily deployed to Preview May 1, 2021 08:28 Inactive
@vercel vercel bot temporarily deployed to Preview May 1, 2021 08:41 Inactive
To stay consistent with the rest of our documentation, for now we should not emojis on the sections of our documentation pages.
@vercel vercel bot temporarily deployed to Preview May 1, 2021 08:44 Inactive
@vercel vercel bot temporarily deployed to Preview May 1, 2021 09:17 Inactive
www/docs/configuration/providers.md Outdated Show resolved Hide resolved
www/docs/configuration/providers.md Outdated Show resolved Hide resolved
www/docs/configuration/providers.md Outdated Show resolved Hide resolved
www/docs/configuration/providers.md Show resolved Hide resolved
Co-authored-by: Balázs Orbán <info@balazsorban.com>
@vercel vercel bot temporarily deployed to Preview May 2, 2021 18:54 Inactive
@vercel vercel bot temporarily deployed to Preview May 2, 2021 18:58 Inactive
@vercel vercel bot temporarily deployed to Preview May 2, 2021 19:16 Inactive
@vercel vercel bot temporarily deployed to Preview May 2, 2021 19:17 Inactive
@ubbe-xyz
Copy link
Collaborator Author

ubbe-xyz commented May 2, 2021

@balazsorban44 addressed all your suggestions 🙇🏽‍♂️

Copy link
Member

@balazsorban44 balazsorban44 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Awesome!

@balazsorban44 balazsorban44 merged commit 6647305 into main May 2, 2021
@balazsorban44 balazsorban44 deleted the docs/1792-providers-params-table branch May 2, 2021 20:07
balazsorban44 added a commit that referenced this pull request May 6, 2021
* Constrain the adapters type generics more accurately

* Add types for the incoming messages to events callbacks

* Code review comments from @lluia

* Rebase from trunk and fix merge conflicts

* Update documentation

* Rip out generics

* fix(build): export aliases from client (#1909)

* docs(provider): update providers documentation (#1900)

* docs(providers): update providers documentation

- delineate clearly the 3 provider types (oauth, email, credentials)
- make each section structure consistent
- update the option list for every provider type
- use emojis

* docs(providers): instructions on new provider types

* docs(providers): remove emojis

To stay consistent with the rest of our documentation, for now we should not emojis on the sections of our documentation pages.

* docs(providers): reword sentence

Co-authored-by: Balázs Orbán <info@balazsorban.com>

* docs(providers): add tip on overriding options

* docs(providers): clarify `params` option usage

* docs(providers): make names list inline

Co-authored-by: Balázs Orbán <info@balazsorban.com>

* fix(ts): unset generics defaults for overriding (#1891)

Co-authored-by: Lluis Agusti <hi@llu.lu>

* fix(ts): tweak Adapter related types (#1914)

Contains the following squashed commits:

* fix(ts): make first adapter parameter non-optional
* fix(ts): make defaulted values non-optional internally
* test(ts): fix linting

* fix(page): don't pass params to custom signout page (#1912)

* For the custom signout page addressed two issues with the query params being added to the signout url. A conditional check on the error value is now made before adding it as a query param. Also added a conditional check on the callbackUrl and if present that then gets appended as a query param to the signout api call.

* Changed fix for bug #192 to have no querystring params in the custom signout page url.

Co-authored-by: anubisoft <anubisoftprez@gmail.com>
Co-authored-by: Lluis Agusti <hi@llu.lu>

* docs(www): fix typo (#1922)

* docs(provider): Update IdentityServer 4 demo configuration (#1932)

* Responding to code review comments

* Fix tests

* Fix lint error

Co-authored-by: Lluis Agusti <hi@llu.lu>
Co-authored-by: Balázs Orbán <info@balazsorban.com>
Co-authored-by: Kristóf Poduszló <kripod@protonmail.com>
Co-authored-by: Anubisoft <1471887+anubisoft@users.noreply.github.com>
Co-authored-by: anubisoft <anubisoftprez@gmail.com>
Co-authored-by: Ernie Miranda <emiranda04@users.noreply.github.com>
Co-authored-by: Mathis Møller <thisen-dk@hotmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Relates to documentation providers
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants