Merge pull request #276 from NASA-Openscapes/2i2c-teams

add page How to Add Folks to 2i2c GitHub Teams

_quarto.yml

@@ -107,7 +107,12 @@ website:
           - text: "Pygeoweaver Workflow Demo"
             href: tutorials/fair-workflow-geoweaver-demo.ipynb
           - text: "MATLAB Access NetCDF"
-            href: tutorials/matlab.qmd            
+            href: tutorials/matlab.qmd
+      - section: "Leading Workshops"
+        href: leading-workshops/index.qmd
+        contents:
+          - text: "2i2c Hub access"
+            href: leading-workshops/add-folks-to-2i2c-github-teams.qmd
       - section: "Workshops & Hackathons"
         href: workshops/index.qmd
         contents:

leading-workshops/add-folks-to-2i2c-github-teams.qmd

@@ -0,0 +1,93 @@
+---
+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 .
+
+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."
+
+![](images/google-form.png){fig-alt="alt text goes here"}
+
+![](images/google-form-notifications.png){fig-alt="alt text goes here"}
+
+3.  When you get an email click '**view response**' (not `view summary`)
+
+![](images/google-form-view-response.png){fig-alt="alt text goes here"}
+
+4.  On the response page, copy the Github Username  ![](images/google-form-gh-username.png){fig-alt="alt text goes here"}
+
+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/github-add-to-team.png){fig-alt="alt text goes here"}
+
+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"}
+
+6.  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/> 
+
+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. 
+
+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.
+
+## Directions for participants
+
+1.  Please go to <https://github.com/nasa-openscapes>
+
+2.  Click the big yellow bar that says "you've been invited" 
+
+3.  Not seeing that bar? 
+
+    1.  Are you logged into [GitHub.com](https://github.com)?
+
+    2.  Have you shared your GitHub username via [this form](https://forms.gle/XRPsKiqaZC4bkYoi8)?
+
+## 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"}
+
+### 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> 

leading-workshops/index.qmd

@@ -0,0 +1,9 @@
+---
+title: Leading Workshops
+---
+
+This section, under development, will include information for workshop prep, setup, and hosting. 
+
+------------------------------------------------------------------------
+
+### [How to Add Folks to 2i2c GitHub Teams](add-folks-to-2i2c-github-teams.qmd)