ndleah / python-mini-project

šŸ™Œ Welcome open-source Python mini-project contributions!
MIT License
3.07k stars 1.21k forks source link
data-analysis data-science data-visualization newbie-code newbie-friendly python python-mini-projects python-programming-exercises python-project-beginner

Star Badge Open Source Love View My Profile View Repositories

forthebadge forthebadge forthebadge forthebadge

Python Mini Projects

A collection of easy Python small projects to help you improve your programming skills.

Issues Pull Requests Forks Stars License

Table Of Contents

image Aim Of The Project

As a Python newbie, I understand the problems that people face when they first begin studying and attempting to understand various Data Science concepts, particularly Python. This project is designed for folks who are just getting started with Python principles and exploring GitHub as "contributors."

My goal is to build a common playground where everyone, from beginners to experts, can learn and share knowledge, and I hope you enjoy your stay here!

Let's "folk-ing" create amazing things together! šŸ‘‰

image Contributing

Step 1: Star The Repo Star the repo by pressing the topmost-right button to start your wonderful journey ![star repo](https://docs.github.com/assets/images/help/stars/starring-a-repository.png)

Step 2: Fork it On the [GitHub page for this repository](https://github.com/ndleah/python-mini-project), click on the Button "**Fork**". ![fork image](https://upload.wikimedia.org/wikipedia/commons/3/38/GitHub_Fork_Button.png)

Step 3: Clone it - **Method 1:** GitHub Desktop > āš ļø **NOTE:** If you're not familiar with Git, using **GitHub Desktop Application** is a better start. If you choose this method, make sure to download it before continuing reading. > > ā—ā— Access link to download [**here**](https://desktop.github.com). Learn more about how to clone the remote respository on your local machine using **GitHub Desktop** [here](https://docs.github.com/en/desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop#cloning-a-repository). - **Method 2:** Git Clone the forked repository. Open git bash and type: ```bash git clone https://github.com//python-mini-project.git ``` > This makes a local copy of the repository in your machine. > > āš ļø **Replace \!** Learn more about [forking](https://help.github.com/en/github/getting-started-with-github/fork-a-repo) and [cloning a repo](https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/cloning-a-repository).

Step 4: Create your feature branch Always keep your local copy of the repository updated with the original repository. Before making any changes and/or in an appropriate interval, follow the following steps: - **Method 1:** GitHub Desktop Learn more about how to create new branch [here](https://docs.github.com/en/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/managing-branches#creating-a-branch) and how to fetch and pull origin from/to your local machine [here](https://docs.github.com/en/desktop/contributing-and-collaborating-using-github-desktop/keeping-your-local-repository-in-sync-with-github/syncing-your-branch). Learn more about how to fetch and pull origin from/to your local machine using **GitHub Desktop** [here](https://docs.github.com/en/desktop/contributing-and-collaborating-using-github-desktop/keeping-your-local-repository-in-sync-with-github/syncing-your-branch). - **Method 2:** Git Run the following commands **_carefully_** to update your local repository ```sh # If you cloned a while ago, get the latest changes from upstream git checkout git pull upstream # Make a feature branch (Always check your current branch is up to date before creating a new branch from it to avoid merge conflicts) git checkout -b # ```

Step 5: Ready, Set, Go... Once you have completed these steps, you are ready to start contributing to the project and creating **pull requests**. - Create a folder in [projects directory](https://github.com/ndleah/python-mini-project) according to your project name. > The folder name should follow the following format "Your_Project_Name_Here". For example: Dice_Stimulator - Write your code and add to the respective folder in the projects directory, locally. - Don't forget to add a `README.md` in your folder, according to the [README_TEMPLATE.](https://github.com/Python-World/python-mini-projects/blob/master/README_TEMPLATE.md) * **Method 1:** GitHub Desktop Learn more how to pull request from your local machine using **GitHub Desktop** to the main repo [here](https://docs.github.com/en/desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/viewing-a-pull-request-in-github-desktop). - **Method 2:** Git Add the changes with `git add`, `git commit`: ```bash git add -A git commit -m "" ``` Push the code _to your repository_. ```bash git push origin ```

Step 6: Pull Request Go to the GitHub page of _your fork_, and **make a pull request**: ![pull request image](https://i.ytimg.com/vi/rgbCcBNZcdQ/maxresdefault.jpg) Read more about pull requests on the [GitHub help pages](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request). Now wait, until _your Pull Request_ is approved! If there are any conflicts, you will get a notification.


image README Template for scripts

please make sure to add a README.md file that follow the same construction as this template for consistency.

README Template

image Our Contributors

image Feedback

If you have any feedback or ideas to improve this project, feel free to contact me via

Reeha's Linkdein

Reeha's Github