Getting started with Github

The following is to be done by each Scrum Master.

1. Log in to the KTH Github and create a repository.
   
   1. In your browser, go to https://gits-15.sys.kth.se/
      You may need to log into KTH if you haven't already done so.
   2. The top right corner of the webpage should now show an avatar image in a circle, with an adjacent triangle. The default looks like this:
   3. Click the triangle and select "Your repositories" in the drop-down menu.
   4. On the Repositories page, click the "New" button. The button looks like this:
   5. In the text-field marked "Repository name", type "ICT2021-" followed by your team name. Example: "ICT2021-Neutron" (if your team is "Team Neutron"). This name will stick throughout the course.
   6. Check the box marked "Initialize this repository with a README". If you accidentally leave out this step, not all parts of your repository will work. To fix this, you can later add a file called "README.md" in the repository.
   7. Click the button "Create repository" (near the bottom of the page).
2. Add the rest of the team as collaborators.
   1. After creating a repository, the page should show the new repository. There are tabs marked Code, Issues, Pull requests, Projects, Wiki, Insights, and Settings. Click the Settings tab.
   2. On the Settings page, there is a menu on the left side. The menu has items for Options, Collaborators, Branches, etcetera. Click the Collaborators item.
   3. An empty list of collaborators appears, with a search box marked "Search by username, full name or email address".
   4. In the KTH Github, the "username" is the same as the email address without the "@kth.se" at the end. For the next step, you need a list of e-mail addresses for your team. If you don't have such a list, open a second browser window and follow the instructions at: Listing the members of your team 
   5. Type the username of one of the other members in your team into the search box. Check that the correct name appears. Click "Add collaborator".
   6. Repeat the previous step until all the other members of the team have been added as collaborators.
   7. If you add someone by mistake, that person can be removed by clicking the "x" after the person's name.
3. Create a project in the new repository.
   1. Click the "Projects" tab.
   2. Click the button "New project".
   3. Under "Project board name", type "Exercise Scrum Board". This project board is only for the Scrum Exercise. For the four-week main project, you will create another project board later.
   4. Under "Project template", select "Basic kanban" from the drop-down list.
   5. Click "Create project".
4. Add cards to your project.
   1. If necessary, go to the repository, click "Projects" and then click "Exercise Scrum Board"
   2. At the top of the left-hand column marked "To do", click the plus sign near the right-hand edge. A new note appears.
   3. Copy and paste the following into the box:
      Reminder service intro - as a user, I want to know the basics about the service before using it.
      Prio - 5000 (by Product Owner), Estimate - 8 (by team)
      How to demo: show a website describing the reminder service with pictures and a few words.
   4. Click "Add".
   5. Create another note with the following text:
      Registration - as a user, I want to use the service with as little registration as possible.
      Prio - 4500 (by Product Owner), Estimate - to be filled in (by team)
      How to demo: enter email address, receive email, click link in email to confirm membership, receive test reminder.
   6. Create a third note with the following text:
      Add reminder - as a user, I want to set a reminder for a future date and time.
      Prio - 4000 (by Product Owner), Estimate - to be filled in (by team)
      How to demo: a registered user sets a reminder for a few minutes away and then waits to see that the reminder e-mail is received.
5. You have finished the setup. Now you can play with your Scrum board. Try moving notes between columns, adding new notes, editing notes, and more. Contact the other members of your team, and tell them that they too can try out the Scrum board.