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

Updating Teams Setup Instructions to account for Admin VS Non-Admin #180

Draft
wants to merge 2 commits into
base: main
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added docs/teams/assets/gh-admin-status.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/teams/assets/gh-auth-request.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/teams/assets/gh-auth.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/teams/assets/select-members.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/teams/assets/select-team.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
48 changes: 40 additions & 8 deletions docs/teams/setting-up-your-team.md
Original file line number Diff line number Diff line change
@@ -1,26 +1,51 @@
---
title: Setting Up Your Team
title: &title Setting Up Your Team
head:
- ['meta', {property: 'og:title', content: *title}]
- ['meta', {name: 'twitter:title', content: *title}]
---

# {{ $frontmatter.title }}

Each StackBlitz Team must be linked in a 1:1 relationship with a corresponding [Github Organization](https://docs.github.com/en/organizations/collaborating-with-groups-in-organizations/about-organizations).
Each StackBlitz Team must be linked in a 1:1 relationship with a corresponding [Github Organization](https://docs.github.com/en/organizations/collaborating-with-groups-in-organizations/about-organizations). If you do not yet have a GithHub Organization, [set one up for free here](https://github.com/account/organizations/new?plan=free) before continuing with the StackBlitz Teams setup process.

:::tip
In the future we plan to support additional version control providers & Teams creation pathways. If linking to a Github Org doesn’t work for you, please [reach out](mailto:[email protected]) and let us know how we can meet your team’s needs!
:::

There are three pathways for setting up a StackBlitz Team depedning on your user persona: <br>

:arrow_right: [Creating New StackBlitz Team From Scratch](#creating-new-stackblitz-team-from-scratch)<br>
This section is for users who are looking to initiaite the StackBlitz Teams setup process. If you are unsure where to start, you should start here.<br><br>

:arrow_right: [Approve an Existing Request to Setup Teams](#approving-a-request-for-stackblitz-teams)<br>
If you are the GitHub Organization Admonistrator and someone on your team has requested StackBlitz Teams, this is the section for you.<br><br>


### Creating New StackBlitz Team From Scratch

To create a StackBlitz Team:
1. Navigate to https://stackblitz.com/pricing
2. Login with a Github account that has Administrator privileges for the Github Organization you will be using to create your StackBlitz Team
3. Click “Select a Team” and click the Github Organization you want to upgrade to StackBlitz Teams
2. Login with a Github account that is a member of the Github Organization you will be using to create your StackBlitz Team.
3. Click “Select a Team” and click the Github Organization you want to upgrade to StackBlitz Teams or click "Add Team" if your organization is not listed:
![Select a team](./assets/select-team.png)
4. Select which members of your Github Organization you want to have a paid StackBlitz Teams account

4. You will now be prompted to authorize StackBlitz Teams to integrated with your Github Organization:
![GH Auth](./assets/gh-auth.png)

At this point you will see a different green button depending on whether you have admin rights for the GitHub organization:
![GH Auth](./assets/gh-admin-status.png)

:bulb: If you are not an admin, this is as far as you can progress without assistance. Your GitHub organization admin(s) will now recieve an email from GitHub requesting their approval. Please share [these instructions ](#approving-a-request-for-stackblitz-teams) with your admin(s) on how to complete the process! <br>

If you are an admin, continue setting up your team below:

5. Select which members of your Github Organization you want to have a paid StackBlitz Teams account:
![Select members](./assets/select-members.png)
5. Either: Start a 14 day free trial OR Skip trial and checkout
6. Notify Invited Team Members

7. Enjoy frictionless collaboration with your team!
6. You can now either start a 14 day free trial or skip trial and checkout via Stripe.

8. Enjoy frictionless in-browser code collaboration with your team!

:::tip
If you opt for the free trial, you will need to add a payment method before the trial expires to continue using the paid Teams features. To do so:
Expand All @@ -34,3 +59,10 @@ If you opt for the free trial, you will need to add a payment method before the

Your StackBlitz Team will now automatically renew as a paid Teams plan at the end of your free trial!
:::

### Approving a Request for StackBlitz Teams
If someone in your organization has requested StackBlitz Teams, these instructions will enable you, the GitHub Organization admin, to complete their request and initiate a 14 day free trial of Teams.

> For an introduction to StackBlitz Teams and what they can do for your organization, check out the [What is StackBlitz Teams page here](./what-is-stackblitz-teams.md).

1.