Skip to content

gdscbvppune/hacktoberfest-practice

Repository files navigation

Note This repository is not included in the Hacktoberfest event, as it is for practice only!

We have other repositories with the label hacktoberfest in the organisation you can contribute to.

The site is live here.

Netlify Status

Running the project

  1. Fork the project.

  2. Clone the repo:

    $ git clone https://github.com/YOUR_GITHUB_USERNAME/hacktoberfest-practice.git
    
  3. Navigate to the cloned directory:

    $ cd hacktoberfest-practice
  4. Install dependencies:

    $ npm install
  5. Run the project

    $ npm run dev

Hacktoberfest Practice Pull Requests

Repository for you to raise a Pull Request to practice open-source! 🎉

All the profile data is stored in content/contributors.json

Option 1. Complete this process in Github (in your browser)

  1. Fork the project.
  • Click the gray Fork button in the top right of this page. This creates your copy of the project and saves it as a new repository in your github account
  1. Create a New Branch:
  • On your new repository's page, click the gray main button in the upper left to reveal a dropdown menu.
  • Enter the name of your new branch in the text box. (Branch names usually make a reference to what is being changed. Example: nameAdd).
  • Click on Create branch <new branch name> and this will automatically take you to your new branch. You can make edits on the main branch, but this may cause issues down the line. Best practice is to create a new branch for each separate issue you work on. That way your main branch remains in sync with GDSC's main branch.
  1. Edit:
  • On the top right of the contributors.json file, click on the pencil icon to edit the file by adding your profile.

  • The json file has this format:

    {
        "name": "Asmit Malakannawar",
        "avatarUrl": "https://avatars.githubusercontent.com/Asmit2952",
        "github": "Asmit2952",
        "twitter": "Asmit_2952",
        "linkedin": "asmit-malakannawar",
        "blogUrl": "https://dev.to/asmit2952"
    },
    

    Make sure to fill the values in the correct way or your profile link won`t work.

    Note: Remove the empty key-value pair i.e the social handle and the link which you haven't entered.

    GitHub: (profilename) only (https://github.com/profilename)

    Twitter: (profilename) only (https://twitter.com/profilename)

    LinkedIn: (profilename) only (https://www.linkedin.com/in/profilename)

  • After editing the contributors.json file, add a commit message and click on the green button saying "Commit Changes". Make sure you have selected the branch you have created.

  1. Raise a Pull Request:
  • Click Pull Requests (which is the third option at the top of this page after the options Code and Issues).
  • Click the green New Pull Request button. This will prep the new pull request for you by autofilling the base repository: base with gdscbvppune: main AND autofilling your head repository: compare with your repository: main
  • Click on your head repository's compare dropdown, and switch branches from your 'main' branch to <new branch name>.
  • Finally, click the green Create Pull Request button. Great job! You did it!

Option 2. Complete this process on your computer (locally)

  • Fork the project: Click the gray Fork button in the top right of this page. This creates your copy of the project and saves it as a new repository in your GitHub account

  • Click on the green Code button, then either the HTTPS or SSH option and, click the icon to copy the URL. Now you have a copy of the project. Thus, you can play around with it locally on your computer.

  • Run the following commands into a terminal window (Command Prompt, Powershell, Terminal, Bash, ZSH). Do this to download the forked copy of this repository to your computer.

  git clone https://github.com/YOUR_GITHUB_USERNAME/hacktoberfest-practice.git
  • Switch to the cloned folder. You can paste this command into the same terminal window.
  cd hacktoberfest-practice
  • Make a new branch. Your username would make a good branch because it's unique.
  git checkout -b <name-of-new-branch>
  • Open the contributors.json file

  • The json file has this format:

    {
        "name": "Asmit Malakannawar",
        "avatarUrl": "https://avatars.githubusercontent.com/Asmit2952",
        "github": "Asmit2952",
        "twitter": "Asmit_2952",
        "linkedin": "asmit-malakannawar",
        "blogUrl": "https://dev.to/asmit2952"
    },
    

    Make sure to fill the values in the correct way or your profile link won`t work.

  • Stage your changes.

  git add contributors.json

or

  git add .
  • Commit the changes.
  git commit -m "Add <your-github-username>"
  • Check the status of your repository.
  git status
  • The response should be like this:
On branch <name-of-your-branch>
nothing to commit, working tree clean
  • Pushing your repository to GitHub.
  git push origin <name-of-your-branch>

or

  git branch -M main
  git push -u origin main

Warning: If you get an error message like the one below, you probably forgot to fork the repository before cloning it. It is best to start over and fork the project repository first.

ERROR: Permission to gdscbvppune/hacktoberfest-practice.git denied to <your-github-username>.
fatal: Could not read from remote repository.
Please make sure you have the correct access rights and the repository exists.
  • On the GitHub website, navigate to your forked repo - on the top of the files section, you'll notice a new section containing a Compare & Pull Request button!

  • Click on that button, this will load a new page, comparing the local branch in your forked repository against the main branch in the EddieHub Hacktoberfest repository. Accept the default values in the dropdown boxes and click the green Create Pull Request button.

Note: A pull request allows us to merge your changes with the original project repo.

  • Your pull request will be reviewed and then eventually merged.

Hurray! You successfully have made your first contribution! 🎉


How can I fix a merge conflict?

A GitHub conflict is when people make changes to the same area or line in a file. This must be fixed before it is merged in order to prevent collision in the main branch.

Credits