What is your suggestion?

I had a lot of trouble understanding our plan for Organizations. I've spent some time talking with @Emyrk , @ammario , and @tjcran about defining what an organization is in this product. I've made a diagram to document my current understanding of our plan:

Some cases we discussed:

• What happens when a user leaves the org/site? - The workspaces are deleted (not currently transferable)
• What happens when a org owner leaves the org/site? - The org is transferred to a different owner

How will this improve the docs?

I'm not proposing we document this explicitly but I do want to make sure everyone is on the same page.

I'd like feedback from those I've tagged above and @deansheather @johnstcn @ketang @kylecarbs as well.

Are you interested in submitting a PR for this?

Sure, if we want to define this somewhere.