Exercise Thursday

Goal: Now that you know how to clone repositories and how to write README.md files, let's practice by adding README.md files written in Markdown to the repositories you created yesterday. Working as a pair, you will add a README.md to one of each student's previous projects.

Warm Up

  • Why are READMEs important?
  • What sections should be included in one? Why?
  • How do we format READMEs?


Add READMEs to Yesterday's Projects

It’s important that we clone our existing repositories rather than just downloading the files. By using git clone we maintain the link to the git repository and can continue to make commits to the same project.

Note: If you are a remote student, you probably have the work you did yesterday still on your computer. Either put those directories in the trash (or in another directory other than the desktop if you're concerned that you didn't properly push your code to GitHub). Then go through the process of cloning your work down again.

Let's start with this:

  • Together with your pair, decide who will drive first. The person with the keyboard will select a GitHub repository (e.g. my-first-webpage) from their account to clone and add a README to.
  • Open Terminal and go to the Desktop folder. (Again, it is important not to clone one project into another project’s folder.)
  • Use git clone to clone the my-first-webpage repository from your GitHub.
  • Type ls in the Terminal and you should see your project folder appear.
  • Go into that project folder in the Terminal.
  • Type git log to confirm that you are in the project folder and can see all of your git commits from your previous work on this project. (If this list of commits is long, you may have to press q to get back to the command line prompt.)
  • Type git remote -v and you should see a remote link nicknamed origin to your remote repository url. (Whenever we clone a project from GitHub the repository we cloned from is automatically included as a remote named origin).
  • Create an empty README.md file by typing touch README.md.
  • Open the project folder in Visual Studio Code by typing code .
  • You should see your my-first-webpage.html file with all of your work, as well as the new, empty README.md file.
  • Go ahead and write a README.md for your my-first-webpage project using the Markdown language, as discussed in the README lesson.
  • The partner not on the keyboard should be a second set of eyes reviewing the Markdown as it is written.

After you finish updating your my-first-webpage project, the owner of the project you're currently working on will commit the new README.md file and push the updated project back up to their GitHub using the following instructions:

  • $ git add . (the "." allows you to add all files without needing to add each individually by name)
  • $ git commit -m "Add README"
  • $ git status to ensure that everything has been committed
  • $ git push origin main to push your updated project back up to GitHub
  • Check on GitHub to make sure that your README shows up correctly on the main project page.

Now that you've added a README.md to your my-first-webpage project, give the keyboard to your partner to allow your pair to do the same for one of their projects. Repeat the directions above.

Lesson 12 of 21
Last updated December 1, 2020