Homework 01
===========

**Due Date: Tuesday, Feb 1, by 11:00am CST**

As Good as Git Gets
-------------------

Your task for the first homework is to create a new Git repository and populate
it with several files / folders. This Git repository must be pushed to GitHub,
and it will be used for the rest of the semester to turn in your homeworks.

Here are the requirements for the Git repository:

* Must contain a top level ``README.md`` with a simple description of what the
  repository contains
* Must contain a directory called ``homework01``
* Must contain a minimum of two different Python scripts, each solving one
  Exercise at the end of the
  `Python Refresher guide <https://coe-332-sp22.readthedocs.io/en/main/unit01/python_refresher.html#exercises>`_
* The directory ``homework01`` must also contain a ``README.md`` file with a
  description of the Python scripts (contents may vary between students)
* **Must contain a minimum of two commits - use git log to see commits**
* Must be pushed to GitHub, and be either public or private (if private, make
  sure to add wallen@tacc.utexas.edu as an collaborator on the repo)

A sample Git repository may contain the following files after completing
homework 01:

.. code-block:: text

   my-coe332-hws/
   ├── homework01
   │   ├── list_generator.py
   │   ├── README.md          # specifically describes the contents of the homework01 directory
   │   └── word_reader.py
   └── README.md              # generally describes the whole repo

What to Turn In
---------------

Send an email to wallen@tacc.utexas.edu with the link to
your GitHub repository and include "Homework 01" in the subject line. We will
clone all of your repos at the due date / time for evaluation.


Additional Resources
--------------------

* `Python Refresher guide <https://coe-332-sp22.readthedocs.io/en/main/unit01/python_refresher.html#exercises>`_
* Please find us in the class Slack channel if you have any questions!