devncode / first-contributions

First Contributions repository for developer to get started with open source.

Just to be clear, pull request in this repo will not count in HacktoberFest

First Contribution

• Thinking about doing an open source contribution?
• Don't know where to start or how to do?
• Looking for a simple repository to help you to get started?

Then look no further, we have created this repository to help you to get started.

Just for the instruction!

If you don't have git installed in your machine, install it.

Fork this repository

Fork this repository by clicking on the fork button on the top of this page. This will create a copy of this repository in your account.

Clone the repository

Now clone the forked repository to your machine. Go to your GitHub account, open the forked repository, click on the clone button and then click the copy to clipboard icon.

Open a terminal and run the following git command:

git clone "URL you just copied"

For example:

git clone https://github.com/this-is-you/first-contributions.git

where this-is-you is your GitHub username. Here you're copying the contents of the first-contributions repository in GitHub to your computer.

Create a branch

Change to the repository directory on your computer (if you are not already there):

cd first-contributions

Now create a branch using the git checkout command:

git checkout -b <add-your-new-branch-name>

For example:

git checkout -b add-muhammad

(The name of the branch does not need to have the word add in it, but it's a reasonable thing to include because the purpose of this branch is to add your name to a list.)

Make necessary changes and commit those changes

Now open contributions.yml file from _data directory in a text editor, add your name with emoji of your country flag, github_account and profile picture URL (avatar) to it. Don't add it at the beginning or end of the file. Put it anywhere in between. Now, save the file.

If you go to the project directory and execute the command git status, you'll see there are changes.

Add those changes to the branch you just created using the git add command:

git add _data/contributions.yml

Now commit those changes using the git commit command:

git commit -m "Add <your-name> to Contributors list"

replace <your-name> with your name.

Push changes to GitHub

Push your changes using the command git push:

git push origin <add-your-branch-name>

replace <add-your-branch-name> with the name of the branch you created earlier.

Submit your changes for review

Now if you go to your repository on GitHub, you'll see a Compare & pull request button. Click on that button.

Now submit the pull request.

Soon, I'll be merging all your pull requests into the master branch of this project. You will get a notification email once the changes have been merged.

Contributors

Thank you to all the contributors who help in making this project better 🙌

first-contributions's Issues

Add yourself in the contributions

Hey guys!

This is good first issue to start contributing first time to open source.

Just go through steps from README.md and you are good to go.

Note: It will not count as your hacktoberfest contribution.

"git add contributions.yml" instead of "git add Contibutors.md" in Readme

Hello there, I think in readme file you should mention this script
git add contributions.yml instead of git add Contributors.md

Show country flag instead of dev image

It will look cool if you country flag instead of dev image or may be dev image.

Suggestions and contributions needed!

Remove link from the name

It's good to remove link from the developer name and color should be mid-night blank #2c3e50

Add Hall of fame for the contributors

Add the Hall of fame for the contributors in README.md using below open source project.

https://gh-hof.netlify.com

Pull requests here won’t count toward Hacktoberfest.

Hi there,

Thank you for your interest in Hacktoberfest and in helping others make their first contributions to open source.

While we agree that it's important to help others, this repository does not do this in a way that is in line with the Hacktoberfest values. Please read the part that talks about high-quality contributions to understand why we are reaching out and taking action. Due to this, we've added this repository to the list of excluded repositories which means pull requests here will not count toward Hacktoberfest 2020.

This is not a DigitalOcean decision, it's one that is inspired by the community of maintainers and contributors who all agree that quality is more important than quantity when it comes to engagement in the Open Source community. The values remind us to shift the focus from contributions to repositories that encourage folks to quickly create and gain a pull request to contributions that will help people level-up their skills and contribute to open-source projects that are in need of help.

If you feel that this repository is an effective learning resource, we encourage you to keep running it since a core part of the aim for Hacktoberfest is to encourage new folks to get involved with open-source.

However, if you are interested in having contributions to this repo count toward Hacktoberfest we encourage you to take a look at this list of Hacktoberfest issues for inspiration and make the necessary changes to focus on enabling people to make meaningful contributions to open source projects.

If you have any questions about this or participating in Hacktoberfest, please contact our team via email [email protected] or join our community Discord server.

Happy Hacking,
The Hacktoberfest Team

Hacktoberfest is presented by DigitalOcean, Intel and DEV.

Handle missing Image

Show some king of general avatar when image is missing.

Correct README.md layout

The layout is kind of out in README.md below is the screenshot for referrence.

HactoberFest

#21

Change hover color of link

It will be great to change color of links when mouse cursor hover like #2c3e50

Links will be like...

1. Header
2. Github logo
3. link and icons in footer