This documentation contains a set of guidelines to help you during the contribution process. I'm happy to welcome all the contributions from anyone willing to add new scripts to this repository. Thank you for helping out and remember, No contribution is too small.
When contributing to this repository, please first discuss the change you wish to make via raising an issue
Follow these steps to make a contribution:
NB: Please use pnpm as your package manager
Fork the ecommerce-api
repository to your GitHub account. Go to your machine and run:
git clone https://github.com/<your-github-username>/ecommerce-api.git
Change into the project folder, in this case (support)
cd ecommerce-api
Create a new branch (This is a necessary step, so don't skip it) and make your changes.
git checkout -b <branch-name>
Add your changes to the staging area.
git add .
Commit your changes (Make your commit short but concise. You can read best commit message practices here
git commit -m "commit message"
Push back to your repo
git push origin main
Create a PR on Github. (Don't just hit the create a pull request button, you must write a PR message to clarify why and what you are contributing)
- Make sure your local branch is always up to date before pushing or making a PR.
- Branch name should reflect what you're working on
- Do not edit/delete someone else's code in this repository. You can only insert new files/folder in this repository.
- Do not make any changes to the config files.
- Fix linting changes before committing.
- Give a meaningful name to whatever file or folder you are adding.
- Raise issues for bugs, don't fix them outrightly.
- When you are contributing, make sure that the work is entirely your own and not from some other source.
- All the scripts must follow PEP 8 Style Guidelines.
-
Markdown : Markdown is a lightweight markup language like HTML, with plain text formatting syntax. Markdown Cheat-Sheet
-
Git : Git is a distributed version-control system for tracking changes in source code during software development. It is designed for coordinating work among programmers, but it can be used to track changes in any set of files.
You can refer to the following articles on basics of Git and Github and also contact me, in case you are stuck:
- Forking a Repo
- Cloning a Repo
- How to create a Pull Request
- Getting started with Git and GitHub
- Learn GitHub from Scratch
- Typescript in 5 minutes
- Getting started with Mongoose
Tip from Victor Eke 😇
It always takes time to understand and learn. So, do not worry at all. I know you have got this! 💪