README.md

GitHub Workflow Activity

Goals

1. Gain some practical use of issue tracker
2. Use issue tracker in conjunction with version control
3. Explore pitfalls when working with an issue tracker in a project
4. Understand the basic developer workflow
5. Understand the role of the issue tracker

Prereq's

• A GitHub account
• Git installed an configured
• JDK installed
• Basic knowledge of Java
• Basic knowledge of git (pull, push, add, commit, clone)

Form Teams of 3 (prefered) or 2

[5 minutes]

• 3-person team
  • Facilitator
    • Read instructions out loud
    • Help team reach consensus
  • Technician
    • SITS IN THE MIDDLE!
    • Carry out operations on the teams behalf
  • Recorder --- Record key insights for team
• 2-person team
  • Facilitator
    • Read instructions
    • Record key insights for team
  • Technician --- Carry out operations on the teams behalf

Prepare

[5-15 minutes]

• Recorder
  • create an etherpad and share the URL with your team
  • list your team members and their roles
• Technician
  • Make sure you have git installed
  • Make sure you have a GitHub account
  • Log into github
  • Make sure Java JDK 2+ is install
• Facilitator
  • Help other team members troubleshoot

Directions

[30-40 min]

1. Give your GitHub handle to your instructor, and s/he'll add you as a collaborator (or a team member).
2. Find the issue tracker, and pick one issue to work on
3. Complete the issue
   1. Clone the repository locally
   2. Make the changes
   3. Commit your changes
   4. Push your changes --- You may have to pull other teams' changes and resolve conflicts one or more times before you can successfully push your changes
4. Review with your team
   1. What worked?
   2. What didn't work and why?
   3. What could you do differently to improve your process next time?

[10 min]

1. Class discussion

---

GitHub Workflow Activity by Stoney Jackson is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.