Skip to content

Commit

Permalink
tidied headers
Browse files Browse the repository at this point in the history
  • Loading branch information
@jules32
jules32 committed Jan 29, 2024
1 parent 7e1a44d commit e9a4547
Showing 1 changed file with 42 additions and 34 deletions.
76 changes: 42 additions & 34 deletions leading-workshops/add-folks-to-2i2c-github-teams.qmd
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,69 +2,76 @@
title: How to Add Folks to 2i2c GitHub Teams
---

1. Ask participants: Please add your GitHub Username to this [Google form](https://forms.gle/XRPsKiqaZC4bkYoi8) for NASA Openscapes JupyterHub Access .
## 1. Share Google Form with participants

2. Set the form responses [Openscapes_JupyterHubAccess](https://docs.google.com/forms/d/1xeSEv_NWIay00M8wWp5NSCFxGtIZvLd148VuRMwPYSs/edit#response=ACYDBNibER-tNcT6dFTmMU54wY9-yl2B-W3kYhQH2PMv_y7uUDbjg1u22FeO0qLZAJIC9BY) to notify when there are responses. Also do this for any separate sheets used for workshop JupyterHub registration<!--- [this sheet](https://docs.google.com/spreadsheets/d/1ipMjDIk7B7oiwanThwXjA_m2JvKA0wbGE01u-Azu75A/edit#gid=1514300535) ---> Click on Responses > click three vertical dots and then check "email notification."
Ask participants: Please add your GitHub Username to this [Google form](https://forms.gle/XRPsKiqaZC4bkYoi8) for NASA Openscapes JupyterHub Access .

![](images/google-form.png){fig-alt="alt text goes here"}
## 2. Google Form response setup

![](images/google-form-notifications.png){fig-alt="alt text goes here"}
Set the form responses [Openscapes_JupyterHubAccess](https://docs.google.com/forms/d/1xeSEv_NWIay00M8wWp5NSCFxGtIZvLd148VuRMwPYSs/edit#response=ACYDBNibER-tNcT6dFTmMU54wY9-yl2B-W3kYhQH2PMv_y7uUDbjg1u22FeO0qLZAJIC9BY) to notify when there are responses. Also do this for any separate sheets used for workshop JupyterHub registration<!--- [this sheet](https://docs.google.com/spreadsheets/d/1ipMjDIk7B7oiwanThwXjA_m2JvKA0wbGE01u-Azu75A/edit#gid=1514300535) ---> Click on Responses \> click three vertical dots and then check "email notification."

3. When you get an email click '**view response**' (not `view summary`)
![](images/google-form.png){fig-alt="alt text goes here" fig-align="center" width="391"}

![](images/google-form-view-response.png){fig-alt="alt text goes here"}
![](images/google-form-notifications.png){fig-alt="alt text goes here" fig-align="center" width="419"}

4. On the response page, copy the Github Username  ![](images/google-form-gh-username.png){fig-alt="alt text goes here"}
## 3. Email alert of new signup
When you get an email click '**view response**' (not `view summary`)

5. Go to [WorkshopAccess-2i2c Team in GitHub](https://github.com/orgs/NASA-Openscapes/teams/workshopaccess-2i2c) > Click Add member > Paste GitHub username. Note there is a separate GitHub team for [LongtermAccess-2i2c](https://github.com/orgs/NASA-Openscapes/teams/longtermaccess-2i2c).
![](images/google-form-view-response.png){fig-alt="alt text goes here" fig-align="center" width="436"}

![](images/github-add-to-team.png){fig-alt="alt text goes here"}
## 4. Copy GitHub username
On the response page, copy the Github Username ![](images/google-form-gh-username.png){fig-alt="alt text goes here" width="406"}

## 5. Paste GitHub username
Go to [WorkshopAccess-2i2c Team in GitHub](https://github.com/orgs/NASA-Openscapes/teams/workshopaccess-2i2c) \> Click Add member \> Paste GitHub username. Note there is a separate GitHub team for [LongtermAccess-2i2c](https://github.com/orgs/NASA-Openscapes/teams/longtermaccess-2i2c).

![](images/github-add-to-team.png){fig-alt="alt text goes here" fig-align="center" width="436"}

GitHub will ask you for 2-factor authentication for the first one you add, not after that.

This is what this looks like in their inbox:

![](images/github-notification-email.png){fig-alt="alt text goes here"}
![](images/github-notification-email.png){fig-alt="alt text goes here" fig-align="center" width="439"}

6. Go back to the form and grab their email address. Send one of the following emails to the person.
## 6. Email confirmation
Go back to the form and grab their email address. Send one of the following emails to the person.

**Email for workshop specific:** 

Subject: NASA Openscapes Access to 2i2c Hub

Hi \[FIRST NAME\] - 

I have added you to the NASA Openscapes GitHub Organization's Workshop Team. Please check your email and accept this invitation from GitHub. Once you have joined the team, you will be able to access the JupyterHub. 

- Here is the link to the hub: <https://openscapes.2i2c.cloud/> 

- Here is the material for the Workshop NAME> <https://nasa-openscapes.github.io/2023-ssc/> 
> Subject: NASA Openscapes Access to 2i2c Hub
> Hi [FIRST NAME],
>
> I have added you to the NASA Openscapes GitHub Organization's Workshop Team. Please check your email and accept this invitation from GitHub. Once you have joined the team, you will be able to access the JupyterHub.
> - Here is the link to the hub: <https://openscapes.2i2c.cloud/>
> - Here is the material for the Workshop NAME\> <https://nasa-openscapes.github.io/2023-ssc/>.
>
> Have a great workshop,
Have a great workshop - 

...

**Email for General requests:** 

Subject: NASA Openscapes Access to 2i2c Hub

Hi \[FIRST NAME\] - 

I have added you to the NASA Openscapes 2i2c Jupyter Hub. Here is the link to the hub: <https://openscapes.2i2c.cloud/> 

There is a getting started guide in the NASA Earthdata Cloud Cookbook here: <https://nasa-openscapes.github.io/earthdata-cloud-cookbook/>

We'd love to know about the kind of work you are doing on the hub, and I'll follow up in the next few months. 
> Subject: NASA Openscapes Access to 2i2c Hub
> Hi [FIRST NAME],
>
> I have added you to the NASA Openscapes 2i2c Jupyter Hub. Here is the link to the hub: <https://openscapes.2i2c.cloud/> 
>
>There is a getting started guide in the NASA Earthdata Cloud Cookbook here: <https://nasa-openscapes.github.io/earthdata-cloud-cookbook/>
>
>We'd love to know about the kind of work you are doing on the hub, and I'll follow up in the next few months. 
Best, 
>Best,
... 



7. In the [Form Response Sheet](https://docs.google.com/spreadsheets/d/10Qg8YtUegXs9bepJzvK4UN54bX8BLXTrhxsjb2uV_6k/edit?resourcekey#gid=1824163684), in Column G add the date they were added to the Hub - in part so that we as admins knew if someone had already fulfilled the request. Rows 453+ are the most recent, but it can vary. Check Column A for the date of the form request.
## 7. Register date in Form Response Sheet
In the [Form Response Sheet](https://docs.google.com/spreadsheets/d/10Qg8YtUegXs9bepJzvK4UN54bX8BLXTrhxsjb2uV_6k/edit?resourcekey#gid=1824163684), in Column G add the date they were added to the Hub - in part so that we as admins knew if someone had already fulfilled the request. Rows 453+ are the most recent, but it can vary. Check Column A for the date of the form request.

## Directions for participants
## Directions for workshop participants

1. Please go to <https://github.com/nasa-openscapes>

Expand All @@ -75,19 +82,20 @@ Best, 
1. Are you logged into [GitHub.com](https://github.com)?

2. Have you shared your GitHub username via [this form](https://forms.gle/XRPsKiqaZC4bkYoi8)?
3. You can also check your email that you use for GitHub and look for an invitation from GitHub and NASA-Openscapes

## Troubleshooting

### Users get 403 error

This is a common issue. User must find email notification from GitHub and accept invitation. If they had clicked in email to accept but did not complete accepting in GitHub, edit their invitation in GitHub to uninvite and reinvite. They should get new email to accept.

![](images/github-pending-member.png){fig-alt="alt text goes here"}
![](images/github-pending-member.png){fig-alt="alt text goes here" fig-align="center" width="399"}

### Didn't get email

Go to <https://github.com/nasa-openscapes>, see the big yellow bar that says You're invited. 

## Notes on process and any issues

Yuvi has started documenting the issues we are running into here -> <https://hackmd.io/tWfqVai4SDC1CbQ4mhfIbw> 
Yuvi has started documenting the issues we are running into here -\> <https://hackmd.io/tWfqVai4SDC1CbQ4mhfIbw> 

0 comments on commit e9a4547

Please sign in to comment.