readthedocs / ext-theme

Read the Docs drop in replacement site templates
3 stars 1 forks source link

Organization: improve where/how we point users to organization creation #290

Open agjohnson opened 4 months ago

agjohnson commented 4 months ago

Currently how/where we are pushing users to create a new organization is not well formed. We do want to limit this as we don't want users to accidentally create a new organization/etc. However, because of that, it's not clear exactly what to do.

To continue the pattern from other listing pages, the button should live here:

image

The button should already exist there, hiding if there are already organizations for the user. But some new options could be a mix of:

humitos commented 4 months ago

I don't we need to give the users the ability to create an organization after creating their account just yet. Unless, until we fully support multiple organization per user. Otherwise, no matter what kind of warning we show to them, they will end up creating another organization by mistake.

agjohnson commented 4 months ago

Yeah agreed on not worrying about making UX for users to create multiple organizations. I am more interested in solving the UX issue of the organization creation view not having an obvious home.

Right now, in the legacy dashboard, organization creation shows on signup if you aren't in an organization yet. This is okay for some use cases, but can also be confusing if you join via SSO and somehow aren't yet in an organization.

There is also an onboarding step that points at creating a new organization in the legacy dashboard, which has its own issues but might be better than forcing users into organization creation. But this also only conditionally shows for users.

Having a spot in the UI for this makes it possible for users to find how to do this when our conditional logic is not helping the user.

agjohnson commented 3 days ago

Also worth noting that if the organization create flow has strong enough protection against users accidentally creating an organization, this button probably doesn't need to be conditional at all. The organization create UI can handle all of the explanation about why users don't need to create an organization in most cases.