|
| 1 | +# Contributing to nigeria_geodata |
| 2 | + |
| 3 | +We’re excited that you want to contribute to nigeria_geodata! By participating, you’re helping to improve this project for everyone. |
| 4 | + |
| 5 | +> And if you like the project, but just don't have time to contribute, that's fine. There are other easy ways to support the project and show your appreciation, which we would also be very happy about: |
| 6 | +> - Star the project |
| 7 | +> - Tweet about it |
| 8 | +> - Refer this project in your project's readme |
| 9 | +> - Mention the project at local meetups and tell your friends/colleagues |
| 10 | +
|
| 11 | +To ensure a smooth process, please follow the guidelines outlined below. |
| 12 | + |
| 13 | + |
| 14 | +## Table of Contents |
| 15 | +1. [How to Contribute](#how-to-contribute) |
| 16 | + - [Reporting Issues](#reporting-issues) |
| 17 | + - [Contributing Code](#contributing-code) |
| 18 | + - [Code of Conduct](#code-of-conduct) |
| 19 | + - [Development Setup](#development-setup) |
| 20 | + - [Documentation](#documentation) |
| 21 | +2. [Helpful Links](#helpful-links) |
| 22 | +3. [Questions?](#questions) |
| 23 | + |
| 24 | + |
| 25 | +## How to Contribute |
| 26 | + |
| 27 | +### Reporting Issues |
| 28 | + |
| 29 | +1. **Search Existing Issues**: Before opening a new issue, please check our [existing issues](https://github.com/jeafreezy/nigeria_geodata/issues) to see if your problem has already been reported or addressed. |
| 30 | +2. **Open a New Issue**: If you don’t find a matching issue, you can open a new one. Provide a clear and descriptive title, and include: |
| 31 | + - A summary of the issue |
| 32 | + - Steps to reproduce the problem |
| 33 | + - Any relevant error messages or screenshots |
| 34 | + - Your environment details (e.g., operating system, browser version) |
| 35 | + |
| 36 | +### Contributing Code |
| 37 | + |
| 38 | +1. **Fork the Repository**: Click the "Fork" button at the top right of this page to create a copy of the repository in your own GitHub account. |
| 39 | +2. **Clone Your Fork**: Clone the forked repository to your local machine: |
| 40 | + ```bash |
| 41 | + git clone https://github.com/jeafreezy/nigeria_geodata.git |
| 42 | + ``` |
| 43 | +3. **Create a New Branch**: Create a new branch for your changes: |
| 44 | + ```bash |
| 45 | + git checkout -b feature/your-feature |
| 46 | + ``` |
| 47 | +4. **Make Your Changes**: Implement your changes on the new branch. Follow our coding style and guidelines. |
| 48 | +5. **Write Tests**: If applicable, write tests to ensure that your changes work as expected and do not break existing functionality. |
| 49 | +6. **Commit Your Changes**: Commit your changes with a descriptive message: |
| 50 | + ```bash |
| 51 | + git add . |
| 52 | + git commit -m "Describe your changes here" |
| 53 | + ``` |
| 54 | +7. **Push Your Changes**: Push your changes to your forked repository: |
| 55 | + ```bash |
| 56 | + git push origin feature/your-feature |
| 57 | + ``` |
| 58 | +8. **Open a Pull Request**: Go to the original repository and open a pull request from your branch. Provide a clear description of your changes and link to any related issues. |
| 59 | + |
| 60 | +### Code of Conduct |
| 61 | +We expect all contributors to follow our [Code of Conduct](https://github.com/jeafreezy/nigeria_geodata/blob/main/CODE_OF_CONDUCT.md). Our goal is to provide a welcoming and inclusive environment for everyone. |
| 62 | + |
| 63 | +### Development Setup |
| 64 | + |
| 65 | +1. **Install Dependencies**: Follow the instructions in the [README.md](link-to-readme) file to set up your development environment. |
| 66 | +2. **Run Tests**: Ensure all tests pass before submitting a pull request: |
| 67 | + ```bash |
| 68 | + python tests |
| 69 | + ``` |
| 70 | + |
| 71 | +### Documentation |
| 72 | +Update the documentation if your changes affect how the project is used or configured. Documentation changes should be made in the same pull request as code changes. |
| 73 | + |
| 74 | +### Helpful Links |
| 75 | +- [Project Documentation](https://jeafreezy.github.io/nigeria_geodata/) |
| 76 | +- [Issue Tracker](https://github.com/jeafreezy/nigeria_geodata/issues) |
| 77 | +- [Pull Requests](https://github.com/jeafreezy/nigeria_geodata/pulls) |
| 78 | +- [Code of Conduct](https://github.com/jeafreezy/nigeria_geodata/blob/main/CODE_OF_CONDUCT.md) |
| 79 | + |
| 80 | +## Questions? |
| 81 | + |
| 82 | +If you have any questions or need assistance, please open an issue or contact us at [email protected]. |
| 83 | + |
| 84 | +Thank you for helping to improve nigeria_geodata! |
0 commit comments