Skip to content

Commit 9316eb1

Browse files
committed
update contribution.md
1 parent ecec4a9 commit 9316eb1

File tree

1 file changed

+84
-0
lines changed

1 file changed

+84
-0
lines changed

CONTRIBUTING.md

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
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

Comments
 (0)