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

chore(docs): make external auth docs easier to follow #12970

Merged
merged 5 commits into from
Apr 20, 2024

Conversation

doodzik
Copy link
Contributor

@doodzik doodzik commented Apr 16, 2024

I was working with @ericpaulsen on setting up Coder. I found the external auth documentation confusing for a first-time reader, so I changed the docs a tiny bit to make it easier to follow.

I also added a k8s environment variable setup section because converting the environment variable to the k8s environment variables was annoying. Now, it can be copy and pasted.

@ericpaulsen, In our call you mentioned that you prefer using GitHub OAuth applications for external auth. Would you like me to switch the docs to use the OAuth application setup proccess instead of the GitHub App one?

@cdr-bot cdr-bot bot added the community Pull Requests created by the community. label Apr 16, 2024
Copy link

github-actions bot commented Apr 16, 2024

CLA Assistant Lite bot All contributors have signed the CLA ✍️ ✅

@doodzik doodzik changed the title add additional context to github external auth provider documentation chore(docs): make external auth docs easier to follow Apr 16, 2024
@doodzik
Copy link
Contributor Author

doodzik commented Apr 16, 2024

I have read the CLA Document and I hereby sign the CLA

cdrcommunity added a commit to coder/cla that referenced this pull request Apr 16, 2024
Copy link
Member

@kylecarbs kylecarbs left a comment

Choose a reason for hiding this comment

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

Thanks for this! It's certainly easier to read through now.

Just a few minor edits, nothing major. Maybe we put USER_DEFINED in <> to be even more explicit?

docs/admin/external-auth.md Outdated Show resolved Hide resolved
docs/admin/external-auth.md Outdated Show resolved Hide resolved
docs/admin/external-auth.md Outdated Show resolved Hide resolved
docs/admin/external-auth.md Outdated Show resolved Hide resolved
docs/admin/external-auth.md Outdated Show resolved Hide resolved
docs/admin/external-auth.md Outdated Show resolved Hide resolved
Co-authored-by: Kyle Carberry <kyle@carberry.com>
docs/admin/external-auth.md Outdated Show resolved Hide resolved
@doodzik
Copy link
Contributor Author

doodzik commented Apr 16, 2024

@kylecarbs great suggestions! I applied them 👍

I also changed USER_DEFINED to USER_DEFINED_ID because it made it a bit more explicit when used throughout the document.

Copy link
Member

@kylecarbs kylecarbs left a comment

Choose a reason for hiding this comment

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

Awesome, thanks!

@ericpaulsen
Copy link
Member

@doodzik thank you for this contribution! let's keep the GitHub App flow for now, it's working well from my testing.

@kylecarbs
Copy link
Member

kylecarbs commented Apr 17, 2024

@doodzik could you apply this patch to fix the formatting?

https://gist.github.com/kylecarbs/9787881a96bd75aaba7a261610390b89

@doodzik
Copy link
Contributor Author

doodzik commented Apr 19, 2024

@kylecarbs Applied the diff. Can you run the CI step again?

@kylecarbs kylecarbs enabled auto-merge (squash) April 20, 2024 16:23
@kylecarbs kylecarbs merged commit b40f54f into coder:main Apr 20, 2024
22 checks passed
@github-actions github-actions bot locked and limited conversation to collaborators Apr 20, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
community Pull Requests created by the community.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants