|
| 1 | +# Contribute to the Papers Repository |
| 2 | + |
| 3 | +We appreciate your interest in contributing to the `clueminati-2025` repository! Please follow these guidelines to ensure a smooth and effective contribution process. |
| 4 | + |
| 5 | + |
| 6 | +## Getting started |
| 7 | + |
| 8 | +- If you're looking for ideas about what to work on, check out our [issues](https://github.com/CodeChefVIT/clueminati-2025/issues) |
| 9 | +- *add feature and bug templates* |
| 10 | + |
| 11 | +## Setting up |
| 12 | +- **Fork** the repository. All the PRs would be made from this fork. |
| 13 | +- **Clone** the repository. |
| 14 | + |
| 15 | +To get the project running, you need to set up your local environment: |
| 16 | + |
| 17 | +- **Create a `.env` file:** Create a new file named `.env` and use the .env.example file to create your own .env file and put in your your own environment variables to make the project functional. |
| 18 | +- **Install dependencies:** Run `pnpm i` in your terminal to install all necessary dependencies. |
| 19 | +- **Checkout staging branch**: Run `git checkout staging` to switch branches. |
| 20 | +- **Run the project:** Run `pnpm dev` to start the project. |
| 21 | + |
| 22 | +## How to Contribute |
| 23 | + |
| 24 | +Once your environment is set up, you're ready to start coding. |
| 25 | + |
| 26 | +- **Create a new branch:** Use the command `git checkout -b yourName/featureName` to create a new branch for your work. |
| 27 | +- **Make your changes:** Write the code to address the issue you were assigned. |
| 28 | +- **Add changed files:** After making your changes, use `git add .` to add the modified files to Git tracking. |
| 29 | +- **Commit your changes:** Please follow standard conventional commit guidelines as outlined here: https://www.conventionalcommits.org/en/v1.0.0/ |
| 30 | +- **Push your changes:** Push your commits to your forked repository using `git push`. |
| 31 | + |
| 32 | +## Submit a Pull Request |
| 33 | + |
| 34 | +- **[Submit your pull request](https://github.com/CodeChefVIT/clueminati-2025/compare):** Please, fill in the Pull Request template - it will help us better understand the PR and increase the chances of it getting merged quickly. |
| 35 | + |
| 36 | +An organization member will review the PR and discuss changes you might have to make before merging it. Any new changes you push to your branch will be automatically attached to the PR. |
| 37 | + |
| 38 | +--- |
| 39 | + |
| 40 | +### Mandatory PR contents |
| 41 | + |
| 42 | +Please ensure that any Pull Request you make contains these things - |
| 43 | + |
| 44 | +- Purpose and issue which the PR is made for. |
| 45 | +- Before & after screenshots if your changes involve any visual adjustments (e.g. UI changes, layout tweaks). |
| 46 | +- List of the major changes made in this PR. |
| 47 | +- Mention of any bug fixes, known issues or follow-ups needed. |
| 48 | + |
| 49 | +**Important:** Ensure no merge conflicts exist before making a PR and run `pnpm build` to check for build errors. |
| 50 | + |
| 51 | + |
| 52 | +### Tips to improve the chances of your PR getting reviewed and merged |
| 53 | + |
| 54 | +- Small, focused & incremental pull requests are much easier to review. |
| 55 | +- Spend time explaining your changes in the pull request body. |
| 56 | +- Low effort PRs, such as those that just re-arrange syntax, won't be merged without a compelling justification. |
0 commit comments