diff --git a/docs/en/Community-Articles/onur-article/how-can-I-contribute-to-open-source-projects-on-github.md b/docs/en/Community-Articles/onur-article/how-can-I-contribute-to-open-source-projects-on-github.md index 3870ea0d5c..f872294476 100644 --- a/docs/en/Community-Articles/onur-article/how-can-I-contribute-to-open-source-projects-on-github.md +++ b/docs/en/Community-Articles/onur-article/how-can-I-contribute-to-open-source-projects-on-github.md @@ -1,8 +1,13 @@ -# How to Contribute To ABP Framework -## What is open source? +# How to Contribute to ABP Framework + +## What is Open Source? Open source software is code designed to be publicly available. Anyone can view, use, modify and distribute your project and code. The fact that the code is open source makes it a natural community and open for improvement. This enables ideas and thoughts to spread rapidly. +## What is ABP Framework? + +ABP Framework is a complete infrastructure to create modern web applications by following the software development best practices and conventions. ABP Framework is completely free, open source and community-driven and provides a free theme and some pre-built modules. ABP is a modular framework and the Application Modules provide pre-built application functionalities. + ## Step 1: Fork the Project The first thing we need to do now is to fork the open source project. Forking will create a copy of the project in your own github account. This will allow users to make changes to the code without affecting the original repository. Just press the fork key in the project. @@ -11,7 +16,7 @@ The first thing we need to do now is to fork the open source project. Forking wi After forking, it will create a new repo in your own github profile. -![fork-image-profile](images/(fork-project-profile.png) +![fork-image-profile](images/fork-project-profile.png) ## Step 2: Clone the Project @@ -35,5 +40,39 @@ In this step, you need to create a new branch of your own before you start devel ## Step 4: Development -Choose a suitable IDE to develop on the new branch you created. In order not to complicate things, we will create a `Developers.md` file and process it +Choose a suitable IDE to develop on the new branch you created. In order not to complicate things, we will create a `Developers.md` file and process it. Let's enter a sample text in the Developers file. + +![developer-list](images/developer-list.png) + +## Step 5: Commit + +You need to use the `git add .` command to add the file you modified. This command adds files from the working directory to the staging area for git. Then use `git commit -m` to commit the changes permanently. + +`git add .` + +`git commit -m ""` + +![commit-image](images/commit-image.png) + +## Step 6: Push the Changes + +The changes you have made so far are only visible on your local machine. The `git push` command is used to push these changes to the repository you forked. + +`git push origin ` + +![push-image](images/git-push-image.png) + +## Step 7: Create a Pull Request + +After the push, go to the github repo you forked. The `Compare and pull request` button will appear on the main page of the repository. Press the button for pull request + +![compare-pull-request](images/pull-request-image.png) + +This will send a pull request to the original repository. Finally, click on the `Create pull request` button. If the pull request is approved and merged, your changes will also appear in the main repository. + +![open-pull-request](images/open-pull-request-image.png) + +That's it! You have contributed to an open source project with your development. + + diff --git a/docs/en/Community-Articles/onur-article/images/commit-image.png b/docs/en/Community-Articles/onur-article/images/commit-image.png new file mode 100644 index 0000000000..951e18b39b Binary files /dev/null and b/docs/en/Community-Articles/onur-article/images/commit-image.png differ diff --git a/docs/en/Community-Articles/onur-article/images/developer-list.png b/docs/en/Community-Articles/onur-article/images/developer-list.png new file mode 100644 index 0000000000..87a7dfb948 Binary files /dev/null and b/docs/en/Community-Articles/onur-article/images/developer-list.png differ diff --git a/docs/en/Community-Articles/onur-article/images/git-push-image.png b/docs/en/Community-Articles/onur-article/images/git-push-image.png new file mode 100644 index 0000000000..1ce8963dbd Binary files /dev/null and b/docs/en/Community-Articles/onur-article/images/git-push-image.png differ diff --git a/docs/en/Community-Articles/onur-article/images/open-pull-request-image.png b/docs/en/Community-Articles/onur-article/images/open-pull-request-image.png new file mode 100644 index 0000000000..4ce50c0491 Binary files /dev/null and b/docs/en/Community-Articles/onur-article/images/open-pull-request-image.png differ diff --git a/docs/en/Community-Articles/onur-article/images/pull-request-image.png b/docs/en/Community-Articles/onur-article/images/pull-request-image.png new file mode 100644 index 0000000000..9eaacaf3db Binary files /dev/null and b/docs/en/Community-Articles/onur-article/images/pull-request-image.png differ