We appreciate your interest in contributing to Tiles! This document outlines the steps and guidelines for contributing to this project. By following these steps, you can ensure your contribution is smoothly integrated into the project.
- Prerequisites
- Fork the Repository
- Clone the Repository
- Create a New Branch
- Make Changes
- Commit Your Changes
- Push to Your Fork
- Submit a Pull Request
- Code Review
Before you start contributing, make sure you have the following tools installed on your local machine:
- Git
- A code editor of your choice, such as Visual Studio Code, Atom, or Sublime Text.
- Navigate to the Tiles GitHub repository.
- Click the "Fork" button in the top-right corner of the page to create a copy of the repository in your GitHub account.
- Open a terminal/command prompt on your local machine.
- Navigate to the directory where you want to clone the repository.
- Run the following command:
git clone https://github.com/YOUR_USERNAME/tiles.git
Replace YOUR_USERNAME
with your GitHub username.
- Navigate to the cloned repository on your local machine:
cd tiles
- Create a new branch using the following command:
git checkout -b your-new-branch-name
Replace your-new-branch-name
with a descriptive name for your branch, such as add-new-feature
.
- Open the project in your preferred code editor.
- Make the necessary changes to the project. This could include adding new features, fixing bugs, or improving existing code.
- Test your changes to ensure they work correctly and do not introduce new bugs.
- Stage the changes you made:
git add .
- Commit the changes with a descriptive commit message:
git commit -m "Your commit message here"
Replace Your commit message here
with a brief description of the changes you made.
- Push your changes to your forked repository on GitHub:
git push origin your-new-branch-name
Replace your-new-branch-name
with the name of your branch.
- Navigate to the Tiles GitHub repository.
- Click the "New pull request" button.
- Click "compare across forks" and select your forked repository and branch from the dropdown menus.
- Review the changes and click "Create pull request."
- Add a descriptive title and any additional comments, then click "Create pull request" again.
Once you have submitted your pull request, the project maintainer(s) will review your changes. They may provide feedback and request changes before merging your contribution. Be sure to address their feedback and make any necessary changes to ensure a smooth integration into the project.
Thank you for your contribution! 🚀