From e9a45471a3bbb4a7e76f96c6469c2fe530c2f2f8 Mon Sep 17 00:00:00 2001 From: Julia Stewart Lowndes Date: Mon, 29 Jan 2024 06:59:15 -0800 Subject: [PATCH] tidied headers --- .../add-folks-to-2i2c-github-teams.qmd | 76 ++++++++++--------- 1 file changed, 42 insertions(+), 34 deletions(-) diff --git a/leading-workshops/add-folks-to-2i2c-github-teams.qmd b/leading-workshops/add-folks-to-2i2c-github-teams.qmd index 9fc75d8d..312fb576 100644 --- a/leading-workshops/add-folks-to-2i2c-github-teams.qmd +++ b/leading-workshops/add-folks-to-2i2c-github-teams.qmd @@ -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 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 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:   -- Here is the material for the Workshop NAME>   +> 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: +> - Here is the material for the Workshop NAME\> . +> +> 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:   - -There is a getting started guide in the NASA Earthdata Cloud Cookbook here: - -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:   +> +>There is a getting started guide in the NASA Earthdata Cloud Cookbook here: +> +>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 @@ -75,6 +82,7 @@ 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 @@ -82,7 +90,7 @@ Best,  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 @@ -90,4 +98,4 @@ Go to , see the big yellow bar that says You ## Notes on process and any issues -Yuvi has started documenting the issues we are running into here ->   +Yuvi has started documenting the issues we are running into here -\>