Currently, documentation on how OAuth is used is unclear in both the API and in the testing logic. Let's clarify that!
Requirements
Tighten up information on how OAuth works, with an eye towards UI developer support.
[ ] Add documentation to /auth/create-user-with-GitHub
[ ] Update /auth/link-to-github's response to indicate what happens after the redirect to GitHub
[ ] Update /auth/login-with-github's response to indicate what happens after the redirect to GitHub
Tests
Tests should be unchanged.
Docs
API and test documentation should be updated.
Open questions
[ ] @joshuagraber Has indicated he might like the OAuth endpoints to return the url for redirection in addition to a 302 that redirects automatically. Let's investigate that as well.
Context
Currently, documentation on how OAuth is used is unclear in both the API and in the testing logic. Let's clarify that!
Requirements
/auth/create-user-with-GitHub
/auth/link-to-github
's response to indicate what happens after the redirect to GitHub/auth/login-with-github
's response to indicate what happens after the redirect to GitHubTests
Docs
Open questions