Legal GitHub

name: inverse
layout: true
class: center, middle, inverse
---
#GitHub
.footnote[Go directly to [project site](https://github.com/zmon/legal-git-hub)]
---
## Please use the new Google Doc
---
## What is it, what can I do with it, and why should I be using it?
---
layout: false

.left-column[
  ## Why 
]
.right-column[
GitHub allows you to:

- Share/Publish
  - This presentation is a GitHub document
- Collaborate
- Communicate

Examples:

- Class Glossary [https://github.com/UMKC-Law/Glossary/blob/master/Version1.md](https://github.com/UMKC-Law/Glossary/blob/master/Version1.md)
- [http://gsa.github.io/Open-And-Structured-Content-Models/index.html](http://gsa.github.io/Open-And-Structured-Content-Models/index.html)
- [http://labs.data.gov/dashboard/offices](http://labs.data.gov/dashboard/offices)
- [https://github.com/GSA/open-data-program-template](https://github.com/GSA/open-data-program-template)
]

---

---

---

.left-column[
## Why
## What

]
.right-column[
  Git + Hub, two words, CamelCased

- Git is a Version Control System
 - Allows you to track changes and versions

- Hub is the social aspect
 - README.md
 - Issues - with labels
 - Wiki - for persistent backgound
 - Collaborators/team - easy access
]

---

.left-column[
## Why
## What
### Git = Versions
]
.right-column[
- Versions
- Branch
 - Final/master
 - Draft/develop
- Distributed
- Tags
 - iOS 5.0, 6.0, 7.0
 - Presented-2-Sep-2015

]
---
.left-column[
## Why
## What
### Git = Versions
]
.right-column[
<img src='images/versions.jpg' style='max-width: 95% !important; max-height: 95% !important;'>

* GitHub generally _only adds_ data
* Integrity: Every file is check-summed before it is stored and checked every time it is retrieved.

]
---

.left-column[
## Why
## What
### Git = Branches
]
.right-column[
<img src='images/main-branches2x.png' style='max-height: 95% !important;'>
]
---
.left-column[
## Why
## What
### Git = Commits
]
.right-column[
<img src='images/my-file.jpg' style='max-width: 95% !important; max-height: 95% !important;'>

* Add and Commit to a repository
]
---
.left-column[
## Why
## What
### Git = Distributed
]
.right-column[
<img src='images/distributed.jpg' style='max-width: 95% !important; max-height: 95% !important;'>
* Three repositories
* Pull request if you do not have write access
* Push if you DO HAVE write access
* Clone to copy a repository
]
---
.left-column[
## Why
## What
## Social (Hub)
]
.right-column[

There are three major social aspects that the Hub has:

- To easily see what the project is about [README.md](https://gist.github.com/susanBuck/d5173196babd1cedfd06) a [better](https://github.com/codeforamerica/CutePets/blob/master/README.md) example
- The ability to suggest and converse about improvements, [issues](https://github.com/UMKC-Law/DataSharingAgreement/issues/7)
- A place to talk about and document a project [Wiki](https://github.com/h5bp/html5-boilerplate/wiki)

Collaborative:

- See each other's work
- Know when changes are made, **Follow**
- See changes made to the work
- Politely suggest changes
  - **Fork** a copy
  - **Edit** your copy
  - **Commit** your changes to your copy
  - **Pull Request**, ask for your changes to be included
]

---
### Organization/Person Home
<img src='images/github-organization-home.png' style='max-width: 95% !important; max-height: 95% !important;'>
---
### Repository Home
<img src='images/github-repository-home.png' style='max-width: 95% !important; max-height: 95% !important;'>
---

.left-column[
  ## Edit
  ## Create a Repository
  ## README.md
]
.right-column[
What a README should do and be:

* Use it to orient people to your project.
* It should be simple and short.
* Could contain:
  * A clear description of the project
  * how and why you would use it
  * list of authors
  * instructions on how to contribute, fork/pull, issues
  * instructions on use and/or install

]

---
### [README.md](https://github.com/codeforkansascity/Neighborhood-Dashboard)
<img src='images/readme.png' style='max-width: 95% !important; max-height: 95% !important;'>
---
### [Issue List](https://github.com/codeforkansascity/Code-for-America-Projects-Hub/issues)
<img src='images/issue-list.png' style='max-width: 95% !important; max-height: 95% !important;'>
---
 
 
 
### Goto this link https://github.com/UMKC-Law/DataSharingAgreement/issues/7
 
 
 
 
 
 
<img src='images/issues.png' style='max-width: 95% !important; max-height: 95% !important;'>
---
### [Wiki](https://github.com/UMKC-Law/Parcel-Assessment-Tool/wiki/Road-Map)
<img src='images/wiki.png' style='max-width: 95% !important; max-height: 95% !important;'>
---
### Edit
<img src='images/github-edit.png' style='max-width: 95% !important; max-height: 95% !important;'>
---
### Changes
<img src='images/github-diff-glossary.png' style='max-width: 95% !important; max-height: 95% !important;'>
* Lines added are in green.
* Lines removed are in red.
* Checksum for the file is in the red circle.
* Commit message "Added Checksum" is at the start, work that was done on the file.

---

## Create your account

* Goto http://github.com
* Click Sign Up, in the upper right hand corner
* Choose the free plan

---

## Lets follow Glossary Project

.left-column[
## Create Account
## Follow
]
.right-column[

We are all going follow this semesters class

- Browse over to [https://github.com/UMKC-Law](https://github.com/UMKC-Law)
- Search for Glossary
- Click the name
- Click the **Watch** pulldown and change to Watching

]

---

## Lets follow another GitHub Project

.left-column[
## Create Account
  ## Follow
]
.right-column[

We are all going follow this semesters class

- Browse over to [https://github.com/UMKC-Law](https://github.com/UMKC-Law)
- Search for spring-2016-class
- Click the name
- Click the **Watch** pulldown and change to Watching

]
---
### Lets make a suggestion

.left-column[
## Create Account
  ## Follow
  ## Issue
]
.right-column[
We will create an issue suggesting that we edit the readme using:

## MarkDown

Instead of HTML
```html
 <h1>List of items</h1>
 <ol>
 <li>This is item one</li>
 <li>This is item two</li>
 </ol>
```

MarkDown

```html
    List of Items
    -------------

* This is item one
    * This is item two
```
]

---

.left-column[
  ## Edit
  ## Create a Repository
]
.right-column[
Create a repository in GitHub:

1. Go Back to your organization/list of repositories
 1. Click on your name in the upper right hand corner
 2. Select "Your Profile"
 3. Click on Repositories in the middle of the tabs
2. Click New green button
3. Fill in:
 * Repository name
 * Description
 * Public
 * Initialize this repository with a README
 * Add a MIT License
]

---
### Create Screen
<img src='images/github-repo-create-step1.png' style='max-width: 95% !important; max-height: 95% !important;'>

---
### Create Forgot to create a file
<img src='images/github-create-no-files.png' style='max-width: 95% !important; max-height: 95% !important;'>

---
### Better looking issues, iron them with waffle.io
<img src='images/waffle.png' style='max-width: 95% !important; max-height: 95% !important;'>

See http://hackshop.waffle.io to create a project/repository with an initial board.

---
## Lets politely make a change

.left-column[
## Create Account
  ## Follow
  ## Issue
  ## Fork
]
.right-column[
We are all going to suggest a change:

-  We are going to add our names to [http://codeforkc.org/meeting-notes/coders.html](http://codeforkc.org/meeting-notes/coders.html)
- Follow the instructions at [http://goo.gl/tVYEBZ](http://goo.gl/tVYEBZ)
  - Fork the KC Brigade Website
  - View your fork in a browser
  - Add your name to the list of coders
  - Commit your changes
  - Issue a Pull Request
]
---

.left-column[
  ## Fin
]
.right-column[
Some resources:
- This slide deck http://zmon.github.io/legal-git-hub
- Markdown Basics [https://help.github.com/articles/markdown-basics/](https://help.github.com/articles/markdown-basics/)
- Mastering Markdown [https://guides.github.com/features/mastering-markdown/](https://guides.github.com/features/mastering-markdown)
- Deep dive Mastering Issues [https://guides.github.com/features/issues/](https://guides.github.com/features/issues/) 
- Pro Git [https://git-scm.com/doc](https://git-scm.com/doc)
- Waffle.io http://waffle.io
]
---
name: last-page
template: inverse

## That's all folks (for now)!

Slideshow created using [remark](http://github.com/gnab/remark).