IntroToGithub



IntroToGithub

0 0


IntroToGithub

Presentation on Intro to Github

On Github jcscottiii / IntroToGithub

Introduction to Github

James Scott

@JamesCScottIII

https://jamescscott.io

Why Github?

In technology, Github is one of the most commonly used software to collaborate.

What does that include?

Access to code for great software that you use.

Peer reviewing

Issue management

Many integrations with external software.

Why do people share code on Github?

Improving the product via community contributions.

But, I don't want to code

Do you want to run a business?

Do you hate navigating through folders and folders of documents?

Organizations are moving towards putting their documents and processes in private repositories. Why?

  • Searchable
  • Central Location
  • Transparency

Bonus:

Github uses @ and #.

=

Interactive collaboration.

Who Uses Github

Resume Replacer!

Have you ever written a one?

Companies are using Github more than the resume.

Showing vs. Telling

Summary of Concepts in These Chapters

Creating your own repository

Learn markdown

Edit Preview

Making a pull request

Commenting on someone else's pull request

"Forking" a Repository

What is Git?

Git is a distributed version control repository system

What is version control?

A way of maintaining multiple versions.

Common usages

  • Production vs. Master
  • Demo branch
  • "I broke something and need to go back and undo is not working".

Creating a Github Account!

Navigate to https://github.com/join

Pick a username that is professional.
  • e.g. Mine is jcscottiii
  • How people will @ you.
E-mail address is a given. Password follow the requirements Click Create an account!

Markdown Quick Start

Headers / Titles

Code Preview # Header 1

Header 1

## Header 2

Header 2

### Header 3

Header 3

#### Header 4

Header 4

.. and so on

Lists

Numbered List

1. one
1. two
1. three
one two three

Bullet List

- a
- b
- c
  • a
  • b
  • c

Font Formatting

Description Code Preview Bold **bold text** bold text Italics *italics text* italics text

Make sure have the asterisks against the text.

No underline in markdown.

Code Block

Code:

`text`

Preview:

text

Link

Code:

[link-text](https://github.com/)

Preview:

link-text

Images

Code

![alt-text](https://assets-cdn.github.com/images/modules/logos_page/GitHub-Mark.png)

Preview

|

Your First Repository

Exercise - Creating a free website hosted by Github.

Go to the Github homepage and find the + button at the top right.

Click the + sign.

You should see the following form:

Create a repository as stated above.

  • Name the repository: <your-username>.github.io.
    • e.g. For the username jcscottiii, the repository should be jcscottiii.github.io.
    • It is important the name has your username.

Launch the web generator

Go to the settings button in your repository.

Scroll down to the Github Pages generator

Change the Page Name to About Me.

Add the following code and fill out your information

## Welcome

My name is Insert First Name

My biggest accomplishment is **insert accomplishment**

My goals for the future are:

1. insert goal #1
1. insert goal #2

Select your template

Afterwards, press "Publish Page"

Visit your website

Go to http://your-username.github.io

Exercise

Icebreaker: Two Truths and A Lie Repository.

Create a repository like before

  • Name it TwoTruths
  • Add the Creative Commons Zero v1.0 Universal license
  • Create it

Need to create a license (or a README) first to get the ability to create a file in the browser.

Creating a file.

Click the Create File Button

Name the file: README.md

If you place a file called README.md in any folder, it will display that for you automatically when you click on that folder.

How to use the form

Edit Preview

Two Truths and A Lie:

Write down two truths and a lie.

Use the Markdown Quick Start

Format it however you want.

DO NOT PRESS THE CREATE FILE BUTTON YET

Committing the File

Change the selection to creating a new branch THEN press "Propose File"

Complete opening the Pull request

Peer Reviewing

Find a partner!

Give the link to the PR to your partner and click the Files Changed section header

Find their lie!

Place your cursor between the line and the text to make a + sign appear.

Add the comment

Find another partner!

Repeat the same exercise. If that second partner agrees with the first partner, they can use reactions on the comment.

Time to confess!

Go back to your own repository and find the file.

Editing a file

Click the pen button to edit the file.

You don't need any special programs to edit a file once you create / upload one. great for non-programmers. Make the changes. If it's a markdown file, you can click the preview button before making the commit.

Committing the updated file

Commit directly to your bio branch.

Go back to your Pull Requests

Click the pull request button near the top.

Merge the pull request

Review your updated README

Becoming one with the Github Ecosystem

Watch

You want to follow activity for that repository

Star

You want to tell the creator: Nice job!

Fork

You want to create a copy for yourself either to:

  • Create a fix / enhancement and contribute back
  • Use as a starting point for your own project.

Clumsy Bird

Goal: Create your own version on your own website

No coding experience needed. Just changing values.

Fork the repository

Go to https://github.com/jcscottiii/clumsy-bird Click the Fork button at the top right.

You need to make a change to deploy your own version. Check out this file:

  • js/entities/entities.js

Look for phrases like:

  • gravity
  • gravityForce

Competition

  • Show me your computer with your high score on your modified game.
  • Show me your code that you changed.
  • ONE Submission

Restriction: Do NOT change the starting score.

Introduction to Github