Docs: Split SSO docs into HowTo/Explanation (Diátaxis) #9801
Conversation
This is an initial attempt. I ended up making a couple decisions: * Breaking each SSO method out into its own page, to make it clearer and rank better on Google * Pulling the content around generic team membership out into its own page, since it wasn't really Google related There's probably some light finishing touches to clean things up, but wanted to get this up today.
There was a problem hiding this comment.
These are mostly changes to the content. I think the structure looks good. This seems fairly uncomplicated to move forwards with.
I left some suggestions for covering a few more SSO approaches (email domain, no SSO at all, and suggestions for new SSO support). We can just chat about that, I don't see it as a blocker.
WRT talks about Feature reference, this has a lot of small but critical features. We should consider starting to track these things. I'm wondering if I should open an issue that we can add such things to.
Co-authored-by: Benjamin Balder Bach <[email protected]>
Co-authored-by: Benjamin Balder Bach <[email protected]>
docs/user/guides/setup-single-sign-on-github-gitlab-bitbucket.rst
Outdated
Show resolved
Hide resolved
docs/user/guides/setup-single-sign-on-github-gitlab-bitbucket.rst
Outdated
Show resolved
Hide resolved
Co-authored-by: Manuel Kaufmann <[email protected]>
Co-authored-by: Manuel Kaufmann <[email protected]>
Co-authored-by: Manuel Kaufmann <[email protected]>
Co-authored-by: Benjamin Balder Bach <[email protected]>
|
Should be ready to merge if folks want to 👍 it. I actually wanted to get this in front of a customer today, so now I'm gonna be motivated to get |
|
Yes, everything resolved 💯 |
|
🎉 |
benjaoming
changed the title
This is an initial attempt.
I ended up making a couple decisions:
There's probably some light finishing touches to clean things up,
but wanted to get this up today.
Refs: #9746