Skip to content

Latest commit

 

History

History
57 lines (36 loc) · 2.6 KB

version-control.md

File metadata and controls

57 lines (36 loc) · 2.6 KB

"Hello World (Local w/ Version Control)" Exercise

Learning Objectives

In this exercise, we'll practice incorporating version control into our local development workflow.

For the version control tool (i.e. Git Client of choice), beginners are encouraged to use GitHub Desktop but any student desiring further exploration can use the Git CLI instead.

Instructions

  1. On GitHub, create a new repository named something like "my-first-repo", and include a "README.md" file. We'll refer to this as the "remote repository".
  2. Use your Git client of choice to "clone" (download) the remote repository onto your local machine, perhaps onto the Desktop. We'll refer to this as the "local repository".
  3. Use your command-line application to navigate into the local repository.
  4. Open the local repository with your text editor.
  5. Use your text editor to edit the README.md file, using content like the example markdown below. Remember to save the file when you're done editing.
  6. Use your text editor to create a new file called "my_script.py" in the root directory of the repository. Add content like the example Python code below. Remember to save the file when you're done editing.
  7. Using your command-line application, ensure you've activated the Anaconda "base" environment, then run the Python file to make sure it produces the desired output.
  8. Use your Git Client to "make a commit" (save a new version) with a message like "Setup project repository".
  9. Use your Git Client to "push" the changes to GitHub / sync with the remote repository.

Example markdown ("README.md" file):

# My First Repo!

This is the README.md file. It uses the markdown language. The line above is a heading, starting with the # sign. Don't be confused that # means something different in .md and .py files.

We can make links like [this](https://github.com/prof-rossetti/intro-to-python).

And lists too:

  + Item 1
  + Item 2
  + Item 3

For more information about Markdown syntax, see the [Markdown Guide](https://www.markdownguide.org/basic-syntax/).

Example Python code ("my_script.py" file):

# this is the "my_script.py" file...

print("HELLO WORLD!")

x = 2 + 2
print(x)

Success Criteria

Once you see the new file contents reflected in your remote repository on GitHub, you have succeeded. Repeat the file-editing, committing and pushing steps at least one more time for good measure.

Further Exploration (Git CLI)

If you are using Git from the command-line, feel free to reference these exercise solutions.