/hometowns

A repository for practicing submitting Pull Requests

MIT LicenseMIT

Home Towns

A repository for practicing submitting Pull Requests. Please add information about your home town to a .csv file. We will then make a map of everyone's home towns!

Step 1: Fork the GitHub repo

To begin, fork the ESIIL Education Hometowns GitHub repository Remember that this step only needs to be done once. When you create this fork, you then have full ownership of the fork in your user account. Full ownership means that you can make direct changes to the fork without submitting a Pull Request.

Step 2: Add a row to hometowns.csv

  1. Click on the hometowns.csv file.

  2. Then, click on the edit button in the upper right. If you haven't forked the repository yet, you will be asked to at this point.

  3. Add at least one new row to the hometowns.csv file for your hometown -- that could be where you live now, somewhere you used to live, or another important location for you. You will add the following information to the file, separated by commas:

    • program you are participating in. The options include:

      1. EDA Certificate
      2. ESIIL Stars
      3. Short Course
      4. Summit
      5. Hackathon
    • date: today's date in YYYY-MM-DD format (for example, January 5, 2024 would be 2024-01-05)

    • type: the type of entry this is. The options include:

      1. Where I live now
      2. Place I've lived
      3. Place I love
    • label: a few sentences about your place

    • image_url: the URL to an image you want to display on the hometowns map

    • image_credit: how you want to credit your image

    • latitude: the latitude of your place

    • longitude: the longitude of your place

The file will look something like this once you add your information:

program,date,type,label,image_url,image_credit,latitude,longitude
Short Course,2024-04-07,Where I live now,Home of ESIIL at the University of Colorado,https://upload.wikimedia.org/wikipedia/commons/thumb/b/b9/Flatirons_Winter_Sunrise.jpg/1024px-Flatirons_Winter_Sunrise.jpg,Taken by Jesse Varner | https://commons.wikimedia.org/wiki/File:Flatirons_Winter_Sunrise.jpg,40.016870,-105.279620

Step 3: Submit a Pull Request To the earthlab-education/ea-bootcamp-hometowns repo

Now that you have made some changes to your fork, submit a pull request from your fork to the original repository:

  1. Select the Pull Requests tab.

  2. You should see a banner saying that you are ahead of the base repository. Select the link in the banner to create a PR with your changes.

  3. Include the following in your pull request:

    • There are a lot of similar PRs in this repository. In the message, include your username and the place you are submitting so the owner can tell the PRs apart easily.
    • In the description, notify the owner of the repository (your instructor) that you have addressed the issue using @github-username.
    • Reference the issue number using Fixes #issue-number (e.g. the issue number is above in the title of this issue). If you are working independently, you may not have an issue with your name on it! Just submit the PR without mentioning an issue.
  4. Confirm by selecting Create Pull Request.