Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/osc-vitap/OpenSource101

This is a starter repository made specifically so we can help you get your first pull request and learn the basics of Git and GitHub.
https://github.com/osc-vitap/OpenSource101

beginner beginner-friendly easy first-pull-request first-pull-request-and-commit first-timers good-first-issue hacktoberfest hactoberfest2023 open-source

Last synced: 3 months ago
JSON representation

This is a starter repository made specifically so we can help you get your first pull request and learn the basics of Git and GitHub.

Awesome Lists containing this project

README 

        
# Welcome to OpenSource101! 





    

    

    

  




This is a starter repository made specifically so we can help you get your first pull request and learn the basics of Git and GitHub.



If you're a beginner and you've come looking for your first contribution, we are here to help.\

We've provided the instructions for you to get started with contributing to Open Source. Scroll down for more info.



## Prerequisites

### 1. Install Git on your computer.





    




Firstly, install Git onto your local system. If you are on linux or mac, you get Git pre-installed.\

However, if you are on Windows you will have to install it. To do so, click [here](https://git-scm.com/).



### 2. Creating a GitHub account.



Head over to [GitHub.com](https://github.com) and create an account by signing up.



### 3. Now what?



Open sourcing and contributing to the free internet is what drives the internet today, and everyone and every single contribution is appreciated in the Open Source world.\

And, you can join us with your first pull request right here!



## First pull request to Glory

### 1. Star and Fork this Repository

You can star and fork this repository on GitHub at the top of the repository.





    




Forking allows you to create a version of the repository for yourself.\

This allows you to make changes to the repository without requiring any permissions or interfering with the existing repository.\

Now, redirect yourself to your fork of the repository, which should have a URL like so,

> https://github.com/your-github-username/OpenSource101



### 2. Clone the repository to your local computer

To make your own copy of the repository that you would want to contribute to, you'll need to clone it to your system for easier access.

Using the `git clone` commmand, you could clone the repository to your local system.

While the URL would essentially be like,

> https://github.com/your-username/OpenSource101.git



It's easier to just click on the clone icon and copy it to your clipboard.





    




After which, just direct yourself to whichever place you wish to clone the repository to using the change directory or `cd` command in terminal and then `git clone` your project.





    




### 3. Create a New Branch



Direct yourself into the repository using `cd OpenSource101/`.

Now, we'll create and switch onto the branch that we will be working on, for editing file in the project.



Creating a branch,

```git

git branch branch-name

```



Switching from main branch to another branch,

```git

git checkout branch-name

```



Viewing all the available branches for your repository,

```git

git branch -a

```





    




### 4. Contribute!



To help make contribution easy, we have made a fixed template for you to work on. Follow the steps provided below.



We can finally get to contributing to the repository now!\

Now that you've switched over to another branch, change your directory to `contributors` using `cd contributors`.



Create a file with your github username with a `.json` extension.\

Example : *GITHUB-USERNAME.json* , where GITHUB-USERNAME is your current GitHub username.



The contents of the JSON file in the below format,

```json

{

    "github-username": "YOUR-GITHUB-USERNAME",

    "favourite-game": "YOUR-FAVOURITE-GAME",

    "favourite-language": "YOUR-FAVOURITE-PROGRAMMING-LANGUAGE",

    "favourite-color": "#FFFFFF"

}

```



```

"github-username" should be the same one as the one you're making the pull request from.



"favourite-game" can be any game that you really like.



"favourite-language" has to be your favourite programming language or any programming language that you really want to learn.



"favourite-color" can be any color in hex format (example: #FFF44F). You can pick any color from Google's color picker.

```



**Note** : Make sure your contributions are in line with our [Code of Conduct](https://github.com/Open-Source-Community-VIT-AP/OpenSource101/blob/main/.github/CODE_OF_CONDUCT.md).



### 5. Committing the changes



You can add all the files that you've updated using the command `git add -A`\

Then, you commit to save the files, like how you would at a checkpoint, `git commit -m "added myself"`



Now, you want to push to your fork online, that works with `git push origin branch-name`.



### 6. Updating the local repository



It is important to keep your local repository updated with the project in order to avoid merge conflicts. To do this, you'll have to configure a remote for the fork and then sync the fork.



#### Configuring a Remote for the fork



In order to create a remote for the fork, you'll need to specify a new remote upstream repoistory (the repository you forked from) to sync with the fork. You'll be using the `git remote add` command to do that.



git remote add upstream https://github.com/Open-Source-Community-VIT-AP/OpenSource101.git



**Note**: We have referenced the original repository as "upstream".



#### Syncing the fork



Once the remote references to the original repository you forked from, you are ready to sync changes in order to keep your local copy up to date. To do this, we use the `git fetch` command.



git fetch upstream



Once done, you need to switch back to the main branch, you can do this using



git checkout main



Now, merge changes made from the original repository's main branch with your current local ,main branch using



git merge upstream/main





    




### 7. Making the pull request



Once your local repository is updated, you are all set to send us a pull request.



To do that, just open your forked repository and click on pull request, now you can see a green button that says "New pull request".



Create the pull request and lay back and relax until you receive a notice signifying the acceptance of your pull request or, the request to modify your changes.



**Note** : If you have any question regarding any of the steps above or about anything related to this repository, just create an issue.



## Open Source and it's wonders



Now, that you've made your first pull request, it's time to explore the vast Open Source network, filled with projects that have ground-breaking potential.\

Projects that can revolutionalize the way we look at things.\

As well as create your own for other people to appreciate and contribute to!



# *Get, Set, Contribute!*