Section 1: Setting up a cohort
Section 2: Managing a cohort
This is a quick start guide for the WDI team looking to get set up with Garnet. Begin by navigating to the Garnet webpage: https://garnet.wdidc.org
The first step in getting set up with Garnet is to sign in. Currently, all sign ins are done via Github. Begin by clicking the "Sign in with Github"" button:
Important Before creating a Cohort on Garnet, make sure that all students, instructors, and teaching assistants have created an account with their github account.
There is currently no button that will take you to the page to start a new cohort, so you will need to navigate your browser to this URL for now:
Once you arrive, you should see a page that looks like this:
You will need to fill out this form as follows:
- Name: This part of the form will be the name of your cohort, the convention is to name is WDI and the number of the cohort, so for example, WDI-21.
- Location: This will be the location of the GA organization you work for.
- Course: This will be the program you teach for (Web Development Immersive = WDI).
- CoreID & Duration in weeks: leave these blank.
- Day of week: The day before your cohort starts, so if the first day is monday, set it to Sunday. This may change, if it does, please update this documentation.
- Start Date: The day before your cohort starts, so if the first day is Febuary 27th, 2017, set it to Febuary 26th, 2017. Again, this may change, if it does, please update this documentation.
Once all the above has been filled out, go ahead and click on create cohort.
The cohort should now be added, and when we navigate back to our main page, we should see a link to the new cohort under "Cohorts you admin".
Let's go ahead and click on this link. This will bring us to our Cohorts page, if everything looks OK, then that's it! Congratulations you've now set up your cohort.
After setting up a cohort, the next step is populate it with cohort admins, and students. The cohort admins will include yourself, your co-instructors, any TAs, and your program producer.
Let's start by adding our admins, on our Cohort page go ahead and click on the Manage Cohort button at the top:
This link takes us to the section where we add members.
Under the "Manage Memberships" Section, go ahead and type the names of all of your admins one at a time. A dropdown should appear showing you their name, go ahead and click their name, and then click "Is admin", and then finally click "add members".
Great, now that we have added our admins to the cohort, time to add the students. Make sure that you have had all students to Garnet by having them Sign in with their github accounts, otherwise they will not show up on the drop down
Now go ahead and repeat the same process as we did before with students, by starting to type in the students Github Handle, if the github handle shows nothing, then try the students name. Again, clicking on their name or github handle when it drops down. The only difference is to not click the "Is admin" button. Go ahead and repeat this process for all students.
Once you have completed this for instructors and students, go ahead and fill out the form at the top of this page, under "Enter start time for events".
Go ahead and click "Auto populate events", and you're done! Now, if we go to our main page, we should see all our students, admins, and attendance.
The last part of setting up the cohort is to scroll to the bottom of this page, and view our attendance section, which should look like this:
Important Make sure you check this over, and make sure none of the dates are repeating themselves, and the given start date of the cohort is accurate. If it is not, it is because you did not set the starting cohort date to a day before the actual start date as specified during the form section of this guide.
If everything looks good then congratulations! You've set up the cohort and populated it with dates, students, and admins. Your cohort is now ready to be used and managed.