Missing documentation for Custom Auth

[dplewis]

Closes: #934
Addresses: #552

Adds deprecation for _linkWith and _loginWith

I can check the links works after this PR is merged.

[codecov]

Codecov Report

Merging #963 into master will decrease coverage by 0.05%.
The diff coverage is 92.85%.

@@            Coverage Diff             @@
##           master     #963      +/-   ##
==========================================
- Coverage   91.94%   91.88%   -0.06%     
==========================================
  Files          54       54              
  Lines        5077     5080       +3     
  Branches     1142     1143       +1     
==========================================
  Hits         4668     4668              
- Misses        409      412       +3

Impacted Files	Coverage Δ
src/FacebookUtils.js	100% <100%> (ø)	⬆️
src/AnonymousUtils.js	100% <100%> (ø)	⬆️
src/ParseUser.js	82.61% <87.5%> (-0.57%)	⬇️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 7ff9f92...d519f0a. Read the comment docs.

[dplewis]

@rhuanbarreto Anything you want to add?

[acinader]

is there anywhere where a user can find a code example of how to do use an auth adapter? I guess in unit tests -- which is where i figured it out, but i still needed your help :). Would be nice to have a working example somewhere...

[dplewis]

There is documentation in the guide Custom Authentication Module. There are some missing documentation in it as well like id field in authData is required.

Working code examples are in ParseUserTest and a working server setup here.

[dplewis]

@acinader Perhaps we should add this to the ReadMe since this highly requested?

[acinader]

1. Yes, I think adding a single sentence with a link in this section: https://github.com/parse-community/parse-dashboard#other-configuration-options in the readme would be a good idea.

2. The guide could use updating to drop the dangling _ (and adding a link to the tests would be a good idea)

this is super nice.

[rhuanbarreto]

I think that this will help more the people looking for answers and it’s enough for now. I managed to implement the Keycloak login but I’m using the REST API for now. Soon I will try to commit something showing how is it on Server side.

[dplewis]

@rhuanbarreto Having another set of eyes always helps as we tend to forget new users have to read through the documentation.

If you can try to use linkWith and provide feedback on if these changes are clear. We would greatly appreciate it.