Updated workshop structure

README.md

@@ -1,93 +1,111 @@
 ![COmanage Logo](https://registry-test.cilogon.org/registry/img/COmanage-Logo-LG-onWhite.png)
 
-# COmanage Lessons
+# COmanage Workshop: Managing Identities & Collaborations
 
-_description will be included here_
+This workshop was taught:
 
-## 100-Level Collection: Basics
+* [November 14-15, 2019, Temple University](https://www.incommon.org/academy/comanage/?preview=true)
 
-_AUDIENCE: First-timers_
+## What is COmanage?
 
-By the end of the 100-level class(es), participants will have a conceptual understanding of COmanage, what it can do, and how it integrates with other tools and processes. Participants will know the areas for increased understanding, and resources needed to move forward.
+**COmanage** is an identity registry with flexible enrollment and lifecycle management capabilities that helps you meet your identity management objectives using standardized tools and approaches. COmanage can be used as a central person registry, a guest management system, or a collaboration hub for scholarly collaborations.
 
-### Core Lessons
+## Workshop Overview
 
-Lesson | Repository | Status
------- | :--------: | ------
-CO101: Introduction to COmanage (self-guided) | [ :octocat: ](https://github.internet2.edu/lpaglione/COmg-CO101-intro) | In Progress
-CO102: COmanage for Virtual Organizations | [ :octocat: ](https://github.internet2.edu/lpaglione/COmg-CO102-voBasics) | In Progress
-CO103: COmanage for University IT | [ :octocat: ](https://github.internet2.edu/lpaglione/COmg-CO103-itIntro) | In Progress
+This two-day hands-on class will provide a conceptual understanding of COmanage, and the technical know-how to get this solution up and running. Whether you represent a research computing center or central IT, you can expect to learn:
 
-### Extended Lessons
+* how to deploy COmanage using the InCommon Docker images from the InCommon Trusted Access Platform and configure it for basic use 
+* configure COmanage so that it works in a way that is customized for your organizational needs
+* how to model your organization or collaboration, and to set up enrollment flows and data processing to get the right people using the right services
+* basics of identifier management and group/role provisioning and management
 
-_none_
+## What to expect
 
-## 200-Level Collection: Installation
+In a nutshell, here is what you can expect over the next two days:
 
-_AUDIENCE: System Administrators_
+* Meeting up to 40 new friends from campuses across the globe
+* Direct access to subject matter experts. Don’t be shy with your questions!
+* Gain experience with the Docker container version of COmanage
 
-By the end of this 200-level class(es), participants will be able to install COmanage and configure it for basic use. The participants will understand how to use plugins and the most common external system integrations. 
+_Knowledge of identity management concepts and related implementation experience is strongly recommended._
 
-_**PREREQUISITE**: A basic understanding of COmanage and its uses, as may be found in the 100-level training._
+## Before you arrive
 
-### Core Lessons
+Detailed preparation instructions will be available and distributed prior to the class. Please note that the training requires you to bring a laptop.
 
-Lesson | Repository | Status
------- | :--------: | ------
-CO201: Installing COmanage Using the InCommon Docker Images | [ :octocat: ](https://github.internet2.edu/lpaglione/COmg-CO201-dockerInstallation) | In Progress
-CO204: Integrating COmanage with Common External Systems | [ :octocat: ](https://github.internet2.edu/lpaglione/COmg-CO204-systemIntegration) | In Progress
+1. The training makes use of Virtual Machines (VMs), in this case derived from Amazon Marketplace Images (AMI) loaded on Amazon Web Services. The training team will provide access instructions when you arrive for the first day of training.
+2. You will need to have an SSH client on your laptop you can use to SSH into the VM.
+3. You will need root/administrator access on the computer you will be bringing to class so that you can modify the local hosts file.
+4. Your VM will be available during the training and for two weeks after the training. After two weeks, the VM will no longer exist, so be sure to save anything you need within two weeks of the end of the training.
 
-### Extended Lessons
+## DAY ONE - Understanding COmanage Structure
 
-Lesson | Repository | Status
------- | :--------: | ------
-CO202: Custom Installations (Self-guided) | |
-CO203: Enabling Plugins (Self-guided) | |
+### Curriculum Outline
 
-## 300-Level Collection: Configuration 
+As with most tools, COmanage uses a specific structure for modeling people and organizations. After getting an overview of the purpose of COmanage, you will get to work installing your own version of COmanage, and starting the process of modeling a simplified organization or collaboration and the people that you will register and manage within COmanage
 
-_AUDIENCE: Application Administrators_
+### Sample Agenda
 
-By the end of this 300-level class(es), participants will be able to configure COmanage so that it works in a way that is customized for their organizational needs. Not all topics will be relevant to all participants. Please refer to the descriptions when selecting training. 
+#### CO101 - Getting to Know COmanage
 
-_**PREREQUISITE**: A basic understanding of COmanage and its uses, as may be found in the 100-level training._
+[ :octocat: ](https://github.internet2.edu/lpaglione/COmg-CO101-intro)
 
-### Core Lessons
+_Description to be updated_
 
-Lesson | Repository | Status
------- | :--------: | ------
-CO301: Modeling Your Collaboration | [ :octocat: ](https://github.internet2.edu/lpaglione/COmg-CO301-cous) | First Draft
-CO302: Setting up Enrollment Flows | [ :octocat: ](https://github.internet2.edu/lpaglione/COmg-CO302-enrollmentFlows) | First Draft
-CO304: Identifier Management | [ :octocat: ](https://github.internet2.edu/lpaglione/COmg-CO304-identifierManagement) | First Draft
-CO306: Group and Role Management | [ :octocat: ](https://github.internet2.edu/lpaglione/COmg-CO306-roleAndGroupMgmt) | First Draft
+In this lesson, you will gain a conceptual understanding of COmanage, what it can do, and how it integrates with other tools and processes. You will better know what you don't know, and will have a general scaffolding to build additional knowledge.
 
-### Extended Lessons
+#### CO201 - Installing COmanage Using the InCommon Docker Images
 
-Lesson | Repository | Status
------- | :--------: | ------
-CO303a: Using Organizational Identity Sources (Self-guided) | |
-CO303b: Working With Provisioners (Self-guided) | |
-CO305: Localizing the Text (Self-guided) | |
-CO350: COmanage Match | |
-CO351: Integrating Registry and Match | |
-CO360: Guest Management | |
+[ :octocat: ](https://github.internet2.edu/lpaglione/COmg-CO201-dockerInstallation)
 
-## 400-Level Collection: Developers 
+In this lesson, you will learn how to install COmanage and configure it for basic use.
 
-_AUDIENCE: Developers_
+#### CO310 - Modeling People in COmanage
 
-By the end of this 400-level class(es), participants will have the tools to be able to customize COmanage for their specific needs. They will learn what can be customized and how, and will leave with some “recipes” to get started with their own projects. Individuals taking this training will be included in a forum (?) that can be used for idea sharing, peer support and collaboration.
+[ :octocat: ](https://github.internet2.edu/lpaglione/COmg-CO10-modelPeople)
 
-### Core Lessons
+COmanage is a registry for people. In this lesson you will learn how people are represented within COmanage. You will explore how COmanage stores and manages information about people and how this information is linked to systems outside of COmanage. You will learn the types of roles that people can play and the privileges that are granted in COmanage as a result. Also covered is how to manage user authentication.
 
-_none_
+#### CO320 - Modeling Organizational Structures in COmanage
 
-### Extended Lessons
+[ :octocat: ](https://github.internet2.edu/lpaglione/COmg-CO320-modelOrg)
 
-Lesson | Repository | Status
------- | :--------: | ------
-CO401: Developing Plugins | |
-CO402: Integration with the REST API | |
-CO403: Hacking the Core (Self-guided) | |
-CO404: Customizing CSS | |
-CO450: Using the Match API with your legacy systems (Self-guided) | |
+When using COmanage with your organization or collaboration, the people that you have registered will naturally fall into groups, perhaps by organizational unit, project team, or the activities that a group of people can do. In this lesson, you will learn how these structures are modeled within COmanage and understand which structures to use to meet your needs.
+
+## DAY TWO - Understanding COmanage's Superpowers
+
+### Curriculum Outline
+
+COmanage has superpowers in linking to other systems and in automating workflows for enrollment and provisioning. On day two, you will customize and build your own enrollment flows, and will set up provisioning so your newly-registered people can be set up to access systems outside of COmanage. You will also set up offboarding policies and learn about the ways that COmanage can be configured or extended to do things that we won't be able to cover during our time together.
+
+### Sample Agenda
+
+#### CO330 - Linking to Systems Outside of COmanage
+
+[ :octocat: ](https://github.internet2.edu/lpaglione/COmg-CO330-linkingExtSystems)
+
+One of COmanage's superpowers is in linking the registered people to their representations in your other systems. These systems include both "inbound systems", or "systems of record" as well as "outbound systems" or "provisioned systems". In this lesson you will learn how COmanage interprets systems of records as sources and links them to the registered people. You will also learn how COmanage shares information about registered people with systems so that these systems can make decisions about the rights and access privileges the person has.
+
+#### CO340 - Workflows: Enrollment
+
+[ :octocat: ](https://github.internet2.edu/lpaglione/COmg-CO350-workflowEnrollment)
+
+Another one of COmanage's superpowers is in being able to manage workflows related to your registered people. A key one of these workflows is the enrollment workflows, or the creation of registered people within COmanage. In this lesson you will learn how enrollment workflows work and how to customize them to meet your needs. You will get to know the common ways that enrollment workflows are initiated, for example, by invitation, self-signup, or account linking. You will understand how to link your registered people to the organizational structures that you created and your "inbound systems" or "systems of record."
+
+#### CO350 - Workflows: Provisioning
+
+[ :octocat: ] (to be added)
+
+The last step of the enrollment workflow is enabling provisioning, or the links between your registered people and "outbound" or "provisioned" systems. These links will enable these "provisioned systems" to make decisions about the rights and access privileges that the person has. In this lesson we will learn the basic structure for enabling these linkages, and review how to set up several commonly provisioned systems.
+
+#### CO360 - Workflows: Offboarding
+
+[ :octocat: ] (to be added)
+
+Eventually people that you have registered will no longer have a connection to part or all of your organization or collaboration. In this lesson we will learn how offboard people: how to unwind provisioning, roles and COmanage access. We will review workflow policies to handle the common reasons for offboarding, and learn how to set up automatic processing.
+
+#### CO370 - Extending COmanage
+
+[ :octocat: ] (to be added)
+
+During this workshop, we learned the basics of COmanage, though it can do so much more. During this lesson, you will whet your appetite for other topics to explore related to COmanage. You will learn how COmanage can be extended through plug-ins, and will be exposed to some of the ways that COmanage can handle more complicated use cases. We will discuss resources for continuing on your COmanage learning journey, and how to connect with the broader COmanage community for support and inspiration.