add github training

Author: pm0kjp

.gitignore

@@ -0,0 +1,2 @@
+
+.DS_Store

README.md

@@ -1,9 +1,23 @@
-# Creating Open Source Informatics Instructional Resources 
+# Creating Open Source Informatics Instructional Resources
 
-This repository contains all materials for the 2022 LIEAF workshop on **Creating Open Source Informatics Instrctuional Resources**.
+This repository contains all materials for the 2022 LIEAF workshop on **Creating Open Source Informatics Instructional Resources**.
 
 The live presentation of this workshop is November 8th at the AMIA 2022 Linking Informatics and Education Academic Forum Conference (LIEAF).
 
+Main topic sections include:
+
+* Working with GitHub
+* Writing markdown
+* Presenting with LiaScript
+
+## Contents
+
+* Working with GitHub:
+
+  - [Slide Deck](https://liascript.github.io/course/?https://raw.githubusercontent.com/arcus/LIEAF2022_workshop/main/github_slides.md)
+  - [Speaker notes](https://liascript.github.io/course/?https://raw.githubusercontent.com/arcus/LIEAF2022_workshop/main/github_speaker_notes.md)
+
+
 ## Important Links
 - [LiaScript](https://liascript.github.io)
 - This page [on GitHub](https://github.com/arcus/LIEAF2022_workshop/blob/main/README.md)

github_slides.md

@@ -0,0 +1,141 @@
+<!--
+title: GitHub
+mode: Presentation
+-->
+
+## Today's Itinerary
+
+* GitHub: Creating a place for your files
+* Markdown: Making documentation readable
+* Liascript: Making documentation beautiful and interactive
+
+## GitHub
+
+* Logging in
+* Creating a new repository (repo)
+* Forking an existing repo
+
+### Logging into GitHub
+
+First step: go to [https://github.com](https://github.com) and either:
+
+* Login (if you have an account)
+* Create an account (it's free!)
+
+#### Your Account Homepage
+
+![](media/github_account_home.png)<!-- style = "max-width:800px; border: 1px solid;" -->
+
+
+#### Version Control
+
+Primitive Version Control (look familiar?)
+
+![](media/primitive_version_control.png)<!-- style = "max-width:600px; border: 1px solid;" -->
+
+#### Git Version Control
+
+Git Version Control:
+
+![](media/git_commits.png)<!-- style = "max-width:800px; border: 1px solid;" -->
+
+#### Text Files: Git's Specialty
+
+Text files:
+
+* .txt files
+* Computer code
+* Configuration files
+* Plain text data (.json, .csv)
+* Markup/Markdown (.xml, .yaml, .md)
+* Anything that is encoded as plain text
+
+Not text files:
+
+* Microsoft Word
+* .pdfs
+* image files
+* PowerPoint
+* Anything that if you open it in a text editor looks like scrambled nonsense
+
+#### Git ≠ GitHub
+
+![](media/git_logo.png)<!-- style = "max-width: 150px;" -->
+
+**is not**
+
+![](media/github_logo.png)<!-- style = "max-width: 200px;"-->
+
+GitHub represents git processes in a nicer-looking way and adds its own bells and whistles.  It's not the only company or website that works really well with git!
+
+### Creating a Repository in GitHub
+
+![](media/new_repository_button.png)<!-- style = "max-width:200px; border: 1px solid;" -->  
+![](media/new_repository_form.png)<!-- style = "max-width:600px; border: 1px solid;" -->  
+
+#### Examine Repository
+
+![](media/repository_view.png)<!-- style = "max-width:800px; border: 1px solid;" -->
+
+#### README.md Example 1
+
+![](media/education_modules_readme.png)<!-- style = "max-width:800px;" -->
+
+#### README.md Example 2
+
+![](media/intro_to_r_readme.png)<!-- style = "max-width:800px; border: 1px solid;" -->
+
+#### Updating Your Repository: First Method
+
+![](media/pencil_icon.png)<!-- style = "max-width:400px; border: 1px solid;" -->  
+![](media/github_editor.png)<!-- style = "max-width:600px; border: 1px solid;" -->  
+
+#### Edit and Preview: First Method
+
+![](media/edit_preview.png)<!-- style = "max-width:900px;" -->
+
+#### Saving Files and Committing: First Method
+
+![](media/commit_message.png)<!-- style = "max-width:10 00px;" -->
+
+#### Getting Back to Repository View
+
+![](media/file_view.png)<!-- style = "max-width:800px; border: 1px solid;" -->
+
+#### Adding a File: First Method
+
+![](media/add_file.png)<!-- style = "max-width:400px; border: 1px solid;" -->  
+![](media/uploader.png)<!-- style = "max-width:400px; border: 1px solid;" -->  
+
+#### Updating Your Repository: Second Method
+
+![](media/github_dev.png)<!-- style = "max-width:500px; border: 1px solid;" -->  
+
+#### Edit and Preview: Second Method
+
+![](media/dev_editor.png)<!-- style = "max-width:800px; border: 1px solid;" -->  
+
+![](media/dev_uncommitted_changes.png)<!-- style = "max-width:800px; border: 1px solid;" -->  
+
+#### Adding a File: Second Method
+
+![](media/dev_new_file.png)<!-- style = "max-width:300px; border: 1px solid;" -->  
+![](media/info_txt.png)<!-- style = "max-width:600px; border: 1px solid;" -->  
+
+#### Saving Files and Committing: Second Method
+
+![](media/source_control_hover.png)<!-- style = "max-width:400px; border: 1px solid;" -->  ![](media/dev_commit.png)<!-- style = "max-width:400px; border: 1px solid;" -->  
+
+#### Get Back to GitHub
+
+To get back to your normal GitHub repository, you can either change ".dev" to ".com" in the URL, or you can click on the "burger" menu (three lines) in the upper left and choose "Go To Repository".
+
+![](media/go_to_repository.png)<!-- style = "max-width:500px; border: 1px solid;" -->
+
+### Forking an Existing Repository
+
+![](media/pbj_fork_button.png)<!-- style = "max-width:500px; border: 1px solid;" -->  ![](media/fork_form.png)<!-- style = "max-width:500px; border: 1px solid;" -->  
+
+#### Looking at Your Fork
+
+![](media/your_fork.png)<!-- style = "max-width:500px; border: 1px solid;" -->