Contributing to an open source project for the first time can be a scary thing. The goal of this repo is to help you take your first steps as an open source contributor by developing a simple (but hopefully fun) quotes-generator. π
Try the live version of the this project: https://react-quote-generator-rho.vercel.app/
Everyone can! (and I mean everyone) π«
π» You donβt have to contribute code. Add a new quote with author, fix a typo, report a bug, add some documentation, do some re-design or add a translation. This project just like most open source projects are in need of all sorts of different contributions. Not just code.
π You are good enough Start off easy by fixing something small (like adding a new quotes). This will help you orient yourself in the project and increase your confidence and experience. No one will judge you if you make a mistake, and you can't break anything! Ask for some pointers if you get stuck. You got this!
When you contribute to Open Source, you are taking part in the collaborative effort of a vast community of passionate developers and contributors! Open Source software allows you to see, use, and more importantly modify its source code. Contributing to Open Source is a great way to develop a deeper understanding of software, and the best part is being able to learn and teach alongside a community of contributors.
Follow this step-by-step guide to make your first open source contribution. The steps you will perform in this guide is a somewhat standard workflow that you will encounter in most projects: Fork -> Clone -> Create a branch -> Make your changes -> Add Changes -> Commit -> Push Changes
The first step is to create a fork of this repo. Do so by clicking on the fork button on the top of this page. A fork is basically your own working copy of this repository.
The next step is to clone the forked repo to your machine.
Go to your GitHub repositories and open the forked repository called Rebus (forked from ollelauribostrom/rebus). Click on the "Clone or download" button and then click the copy to clipboard icon to get your url.
Finally run the following git command in your terminal:
git clone "the copied url"
Runs the app in the development mode.
Open http://localhost:3000 to view it in your browser.
The page will reload when you make changes.
You may also see any lint errors in the console.
Create a branch on your machine
git switch -c <your new branch>
...
...sh
> Note: Replace `<your-new-branch>` with something that describes the changes you are about to make
Now it's time to make your changes. Let's add a new quotes.
- Open the file
QuotesData.js
in your favourite editor (preferable VSCode π). - Add a new quote to the end of the
quotes
array. - Save the file when you are done.
Initailize new changes by writing these command on your terminal
git add <the section of the file you made changes to>
Commit your change to the main branch by running
git commit -m "Your message"
Push your changes to GitHub by running:
git push origin <your-new-branch-name>
Note: Replace
<your-new-branch-name>
with the name of your branch
Head over to your repository on GitHub and click on the green "Compare and pull request" button.
Describe your changes and submit your pull request
π Congratulations π
You just took your first step as an open source contributor. Your pull request will be reviewed as soon as possible.
Please read the full text so that you can understand what actions will and will not be tolerated.
Please kindly remember to star this repo. Thank you for your contribution.
Licensed under the MIT License.