First full document

episodes/01-orientation.md

@@ -6,7 +6,7 @@
 
 * What is your name?
 * Where are you from?
-* Why are you taking this class?
+* Why are you taking this class? First time to COmanage? Refreshing knowledge?
 * What is something that would happen here that would make you feel like this was a great use of your time?
 
 ### Hands On - Add yourself to the Etherpad
@@ -31,10 +31,31 @@ Etherpad: https://beta.etherpad.org/p/LAWk3BnFJooMVMCHq56L
 
 https://github.internet2.edu/lpaglione/COmg-trainingOverview/blob/master/README.md
 
-* Documentation structure
-* Your packets - some pen-to-paper activities
-* Documentation conventions
-  * Hands on activities
-  * Icons
-* Course scope and objective
+### Documentation structure
 
+The lessons that we will be going over during this Workshop cover a subset of topics about COmanage. The 100-level lessons (like this one!) are designed to provide an orientation to COmanage. 200-level lessons discuss installation and configuration. 300-level lessons provide insight into specific features of COmanage. And, 400-level lessons (which are not included in this Workshop) provide insights and training to those who may be writing code to extend or customize what COmanage can do.
+
+We have selected a set of lessons with some specific goals:
+
+* Provide you with a strong understanding of what COmanage is designed to do and how it may fit your needs
+* Ensure that you are oriented to COmanage's structure and terminlogy so that you be well positioned to extend your knowledge via COmanage's online documentation
+* Provide a hands-on experience in working wtih COmanage in an enviornment where there are plenty of resources to support your learning.
+
+### Paper? In a tech workshop?
+
+Recognizing that different people "lock in" new knowledge in different ways, we wanted to provide you will context-specific resources that can help trigger the recall of key concepts when you head back to your home institutions. The work we will be doing will be hands on, though these environments will be on Virtual Machines that will be refreshed in two weeks. 
+
+The packets provide planning worksheets for you to jot down how you may apply these concepts to your own enviornment. These insights will help provide a great starting point when you are starting to implement some of these ideas on your own.
+
+### Documentation conventions
+
+If you see the hands on image (like above!), it will be time for you to put fingers to keyboard and try things out. In many cases we will ask you to set up specific things, and sometimes you'll have flexibility in what you create. Regardless, it is important for your understanding that you do all of the hands on activities. Later lesson activities will build on earlier ones.
+
+:gear: icon - These indicate COmanage objects that we will be learning throughout the workshop
+:crown: icon - These icons indicate specific administrator roles.
+:memo: icon - These are links to the worksheets and resources that we will be referencing during the workshop. 
+:rocket: icon - COmanage makes several processes easier by automating work.
+
+### Contributing to training materials
+
+Do you see a typo that is annoying you? You've thought about a better way of explaining a concept? We encourage you to contribute those ideas! The training documentation is stored on Github. You can either create an issue, or you are welcome to submit a pull request with your ideas.