Intro to GitHub (Activity)

From Foss2Serve
(Difference between revisions)
Jump to: navigation, search
(added comments and additional info)
(Fix link)
 
(26 intermediate revisions by 8 users not shown)
Line 1: Line 1:
== Preparation ==
+
__NOTOC__
  
{| border="1"
+
{{Learning Activity Overview
|-
+
|title=
|'''Title''' ||
+
Intro to GitHub
Introduction to Github
+
|overview=
|-
+
Learner will get started with Git by working on a remote repository shared by other workshop learners.
|'''Overview''' ||
+
|prerequisites=
Learner will get started with Git and Github by working on a remote repository shared by other workshop learners. How to fork, edit, and push with Git.
+
* A basic understanding of command-line usage would be helpful, but not required.
|-
+
|objectives=
|'''Prerequisite Knowledge''' || A rudimentary understanding of command-line usage would be helpful, but not required.
+
|-
+
|'''Estimated Time to Completion''' || 30-60 minutes
+
|-
+
|'''Learning Objectives''' ||Upon completion, you will be able to
+
 
* Install Git.
 
* Install Git.
 
* Configure Git.
 
* Configure Git.
Line 19: Line 14:
 
* Make changes to a repository.
 
* Make changes to a repository.
 
* Commit changes to a GitHub repository.
 
* Commit changes to a GitHub repository.
* Issue pull requests to an upstream repository.
+
|process skills=
|-
+
}}
|'''Materials/Environment''' ||
+
* Access to Internet/Web and web browser
+
|-
+
|'''Additional Information''' ||
+
* Git website: http://git-scm.com
+
* Repository location: https://github.com/foss2serve/git-activity/
+
|-
+
|'''Rights''' || Licensed CC BY-SA (?)
+
|-
+
|'''Turn In''' || Your information added to a shared repository.
+
|}
+
 
+
  
 
=== Background ===
 
=== Background ===
Line 38: Line 21:
 
For the impatient, you may skip down to the [Directions] section and get started. If you would prefer an overview of Git first, there are some great introductory videos on Git's site: http://git-scm.com/ . Namely:
 
For the impatient, you may skip down to the [Directions] section and get started. If you would prefer an overview of Git first, there are some great introductory videos on Git's site: http://git-scm.com/ . Namely:
  
* Git Basics: What is Version Control?
+
* Git Basics: What is Version Control?<br/><br/>If you are new to version control, or just want to gain a deeper understanding of it, this is 6 minutes of your life well spent.<br/><br/>[http://git-scm.com/video/what-is-version-control Watch the video]<br/><br/>
** If you are new to version control, or just want to gain a deeper understanding of it, this is 6 minutes of your life well spent.
+
** [http://git-scm.com/video/what-is-version-control Watch the video]
+
  
* Git Basics: What is Git?
+
* Git Basics: What is Git?<br/><br/>This 8 minute video gives you a quick overview of git, why it exists, who it serves, what it can do, and explains some of its advantages.<br/><br/>[http://git-scm.com/video/what-is-git Watch the video]<br/><br/>
** This 8 minute video gives you a quick overview of git, why it exists, who it serves, what it can do, and explains some of its advantages.
+
**[http://git-scm.com/video/what-is-git Watch the video]
+
  
* Git Basics: Get Going with Git
+
* Git Basics: Get Going with Git<br/><br/>This 4.5 minute video gives you an overview of installing and configuring git, as well as how to set up your first git repository.  You could try to follow along and attempt each step, but I recommend just observing for now and appreciating the simplicity of setup.  Later you'll complete a tutorial that will have you perform these same steps.<br/><br/>[http://git-scm.com/video/get-going Watch the video]<br/><br/>
** This 4.5 minute video gives you an overview of installing and configuring git, as well as how to set up your first git repository.  You could try to follow along and attempt each step, but I recommend just observing for now and appreciating the simplicity of setup.  Later you'll complete a tutorial that will have you perform these same steps.
+
** [http://git-scm.com/video/get-going Watch the video]
+
 
+
* Git Basics: Quick Wins with Git
+
** Still not convinced?  Need more reasons to use Git?  Whether you are gearing up for a water cooler debate about version control systems, or you just want to get a better understanding of the Git philosophy and the features that implement those philosophies, this 5 minute delivers.
+
** [http://git-scm.com/video/quick-wins Watch the video]
+
  
 +
* Git Basics: Quick Wins with Git<br/><br/>Still not convinced?  Need more reasons to use Git?  Whether you are gearing up for a water cooler debate about version control systems, or you just want to get a better understanding of the Git philosophy and the features that implement those philosophies, this 5 minute delivers.<br/><br/>[http://git-scm.com/video/quick-wins Watch the video]<br/><br/>
  
 
=== Directions ===
 
=== Directions ===
  
# Complete http://try.github.com.
+
1. Git: Download, install, and configure git as demonstrated in the videos above.
# Log into GitHub.
+
2. GitHub: Go to https://github.com/foss2serve/github-rollcall-activity and follow the instructions there.
# Fork [https://github.com/foss2serve/git-activity this repository].
+
# In your forked copy, add your information to rollcall.md.
+
# Issue a pull request back to [https://github.com/foss2serve/git-activity this repository].
+
  
 +
=== Additional Information ===
  
=== Deliverables: ===
+
* Git website: http://git-scm.com
The teacher, who is in charge of the [https://github.com/foss2serve/git-activity upstream repository], will get the pull request. A proper pull request, with a relevant commit comment and edited file are expected.
+
* Repository location: https://github.com/foss2serve/github-rollcall-activity/
  
 +
=== Deliverables ===
  
=== Assessment: ===
+
POSSE: Correctly completing the activity on GitHub will add you to the POSSE roll call list on GitHub.
{| border="1"
+
|-
+
|'''Criteria''' ||'''Level 1 (fail)'''||'''Level 2 (pass)'''||'''Level 3 (good)'''||'''Level 4 (exceptional)'''
+
|-
+
|Pull Request || No request received ||  ||  || Pull request received
+
|-
+
|Commit comment || No commit comment || Commit comment is there but not relevant || Commit comment is relevant but lengthy  || Commit comment is relevant and concise
+
|-
+
|Edited file || No or wrong file edited ||  ||  || rollcall.md file edited and personal information added
+
|-
+
|}
+
  
 +
= Notes for Instructors =
  
=== Comments: ===
+
The remaining sections of this document are intended for the instructor.  They are not part of the learning activity that would be given to students.
What are some likely difficulties that an instructor may encounter using this activity?
+
Students may get caught up on which order to enter commands into the command line. Review resources at http://git-scm.com/doc
+
  
 +
=== Assessment ===
  
=== Additional Information: ===
+
* How will the activity be graded?
{| border="1"
+
* How will learning will be measured?
|-
+
* Include sample assessment questions/rubrics.
|'''Knowledge Area/Knowledge Unit''' || What ACM Computing Curricula 2013 knowledge area and units does this activity cover? [[ACM_Body_of_Knowledge]]
+
 
 +
{| border="1" class="wikitable"
 +
! Criteria
 +
! Level 1 (fail)
 +
! Level 2 (pass)
 +
! Level 3 (good)
 +
! Level 4 (exceptional)
 
|-
 
|-
|'''Topic''' || What specific topics are addressed? The Computing Curriucula 2013 provides a list of topics - https://www.acm.org/education/CS2013-final-report.pdf
+
| '''Criteria 1'''
 +
|  
 +
|  
 +
|
 +
|
 +
 
 
|-
 
|-
|'''Level of Difficulty''' || Is this activity easy, medium or challenging?
+
| '''Criteria 2'''
|-
+
|  
|'''Estimated Time to Completion''' ||  How long should it take for the student to complete the activity?
+
|  
|-
+
|  
|'''Materials/Environment''' || What does the student need?  Internet access, IRC client, Git Hub account, LINUX machine, etc.?
+
|  
|-
+
 
|'''Author''' || Who wrote this activity?
+
|-
+
|'''Source''' || Is there another activity on which this activity is based?  If so, please provide a link to the original resource.
+
|-
+
|'''License''' || Under which license is this material made available? (http://creativecommons.org/licenses/)
+
 
|}
 
|}
  
 +
=== Comments ===
  
=== Suggestions for the Open Source Project: ===
+
* What should the instructor know before using this activity?
Suggestions for an open source community member who is working in conjunction with the instructor.
+
* What are some likely difficulties that an instructor may encounter using this activity?
  
 +
{{Learning Activity Info
 +
|acm unit=
 +
|acm topic=
 +
|difficulty=
 +
Easy
 +
|time=
 +
30-60 minutes
 +
|environment=
 +
Access to Internet/Web and web browser.
 +
|author=
 +
Stoney Jackson
 +
|source=
 +
None
 +
|license=
 +
{{License CC BY SA}}
 +
}}
  
--------------------
 
This work is licensed under a
 
[http://creativecommons.org/licenses/by-sa/4.0/ Creative Commons Attribution-ShareAlike 4.0 International License]
 
  
[[File:CC_license.png]]
+
=== Suggestions for Open Source Community ===
 +
 
 +
Suggestions for an open source community member who is working in conjunction with the instructor.
 +
 
  
[[Category: Learning_Activity]]
+
[[Category:Learning Activity]]
[[Category:Communication_and_Tools]]
+
[[Category:Communication and Tools]]
 +
[[Category:Git]]
 +
[[Category:CS Principles]]
 +
[[Category:CS1]]
 +
[[Category:CS2]]
 +
[[Category:Good Draft]]

Latest revision as of 13:28, 31 May 2019


Title

Intro to GitHub

Overview

Learner will get started with Git by working on a remote repository shared by other workshop learners.

Prerequisites
  • A basic understanding of command-line usage would be helpful, but not required.
Learning
Objectives
After successfully completing this activity, the learner should be able to:
  • Install Git.
  • Configure Git.
  • Fork a GitHub repository.
  • Make changes to a repository.
  • Commit changes to a GitHub repository.
Process Skills
Practiced


Background

For the impatient, you may skip down to the [Directions] section and get started. If you would prefer an overview of Git first, there are some great introductory videos on Git's site: http://git-scm.com/ . Namely:

  • Git Basics: What is Version Control?

    If you are new to version control, or just want to gain a deeper understanding of it, this is 6 minutes of your life well spent.

    Watch the video

  • Git Basics: What is Git?

    This 8 minute video gives you a quick overview of git, why it exists, who it serves, what it can do, and explains some of its advantages.

    Watch the video

  • Git Basics: Get Going with Git

    This 4.5 minute video gives you an overview of installing and configuring git, as well as how to set up your first git repository. You could try to follow along and attempt each step, but I recommend just observing for now and appreciating the simplicity of setup. Later you'll complete a tutorial that will have you perform these same steps.

    Watch the video

  • Git Basics: Quick Wins with Git

    Still not convinced? Need more reasons to use Git? Whether you are gearing up for a water cooler debate about version control systems, or you just want to get a better understanding of the Git philosophy and the features that implement those philosophies, this 5 minute delivers.

    Watch the video

Directions

1. Git: Download, install, and configure git as demonstrated in the videos above. 2. GitHub: Go to https://github.com/foss2serve/github-rollcall-activity and follow the instructions there.

Additional Information

Deliverables

POSSE: Correctly completing the activity on GitHub will add you to the POSSE roll call list on GitHub.

Notes for Instructors

The remaining sections of this document are intended for the instructor. They are not part of the learning activity that would be given to students.

Assessment

  • How will the activity be graded?
  • How will learning will be measured?
  • Include sample assessment questions/rubrics.
Criteria Level 1 (fail) Level 2 (pass) Level 3 (good) Level 4 (exceptional)
Criteria 1
Criteria 2

Comments

  • What should the instructor know before using this activity?
  • What are some likely difficulties that an instructor may encounter using this activity?
ACM BoK
Area & Unit(s)
ACM BoK
Topic(s)
Difficulty

Easy

Estimated Time
to Complete

30-60 minutes

Environment /
Materials

Access to Internet/Web and web browser.

Author(s)

Stoney Jackson

Source

None

License

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License

CC license.png


Suggestions for Open Source Community

Suggestions for an open source community member who is working in conjunction with the instructor.

Personal tools
Namespaces
Variants
Actions
Events
Learning Resources
HFOSS Projects
Evaluation
Navigation
Toolbox