african-states-and-tribes 1.1.1 → 1.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/CONTRIBUTING.md +57 -0
- package/.github/PULL_REQUEST_TEMPLATE.md +33 -0
- package/README.md +2 -2
- package/SECURITY.md +4 -3
- package/package.json +1 -1
- package/docs/CONTRIBUTING +0 -1
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
# Contributing to African States and Tribes
|
|
2
|
+
|
|
3
|
+
:+1: :tada: First off, thanks for taking the time to contribute! :tada: :+1:
|
|
4
|
+
|
|
5
|
+
The following is a set of guidelines for contributing to the **African States and Tribes** project. These are mostly guidelines, not strict rules—use your best judgment, and feel free to propose changes via a pull request.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## How Can I Contribute?
|
|
10
|
+
|
|
11
|
+
### 🛠 Fixing Data Yourself
|
|
12
|
+
|
|
13
|
+
If you've spotted incorrect or outdated data, feel free to correct it and raise a pull request.
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
### 🌍 Contributing to the Tribes Database
|
|
18
|
+
|
|
19
|
+
- The African tribes database is located in the `src/data/africa/tribes` folder.
|
|
20
|
+
- Each file in this folder represents a single country and is named using the [ISO 3166-1 alpha-2 code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
|
|
21
|
+
- Refer to the `README.md` for details on the structure and meaning of the properties used in the tribes files.
|
|
22
|
+
- You may suggest updates or improvements as needed.
|
|
23
|
+
- If you're adding new data, including a reference or source will increase the chances of your pull request being accepted.
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
### 🗺 Contributing to the African Countries Database
|
|
28
|
+
|
|
29
|
+
- The list of African countries can be found in the `src/data/africa/countries.json` file.
|
|
30
|
+
- You may suggest updates or improvements to this file as needed.
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
### ✨ Suggesting or Implementing New Features
|
|
35
|
+
|
|
36
|
+
- New features can be implemented in the `src/index.ts` file.
|
|
37
|
+
- All new feature suggestions will be reviewed to ensure they align with the project’s goals.
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
## 📋 How to Contribute via Pull Request
|
|
45
|
+
|
|
46
|
+
1. **Fork** the repository to your own GitHub account.
|
|
47
|
+
2. **Clone** your forked repo locally:
|
|
48
|
+
```bash
|
|
49
|
+
git clone https://github.com/your-username/african-states-and-tribes.git
|
|
50
|
+
cd african-states-and-tribes
|
|
51
|
+
3. git checkout -b your-branch-name
|
|
52
|
+
4. git commit -m "Short description of your change"
|
|
53
|
+
5. git push origin your-branch-name
|
|
54
|
+
6. Open a Pull Request from your branch to the main branch of the original repo.
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
Thank you for helping make this project better! Happy contributing!
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# Pull Request
|
|
2
|
+
|
|
3
|
+
## Description
|
|
4
|
+
|
|
5
|
+
Please include a summary of the changes and the related issue(s). Explain the motivation behind this PR and any context that might be useful.
|
|
6
|
+
|
|
7
|
+
Fixes # (if applicable)
|
|
8
|
+
|
|
9
|
+
## Type of Change
|
|
10
|
+
|
|
11
|
+
- [ ] Bug fix (non-breaking change that fixes an issue)
|
|
12
|
+
- [ ] New feature (non-breaking change that adds functionality)
|
|
13
|
+
- [ ] Data update (new or updated tribe or country data)
|
|
14
|
+
- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
|
|
15
|
+
- [ ] Documentation update
|
|
16
|
+
|
|
17
|
+
## Checklist
|
|
18
|
+
|
|
19
|
+
- [ ] My code follows the style guidelines of this project
|
|
20
|
+
- [ ] I have performed a self-review of my changes
|
|
21
|
+
- [ ] I have commented my code, particularly in hard-to-understand areas
|
|
22
|
+
- [ ] I have added or updated relevant documentation
|
|
23
|
+
- [ ] My changes generate no new warnings or errors
|
|
24
|
+
- [ ] I have added tests that prove my fix is effective or that my feature works (if applicable)
|
|
25
|
+
- [ ] New and existing unit tests pass locally with my changes
|
|
26
|
+
|
|
27
|
+
## Screenshots / Data Samples (if applicable)
|
|
28
|
+
|
|
29
|
+
Include any visuals or JSON snippets that help reviewers understand your changes.
|
|
30
|
+
|
|
31
|
+
## Additional Notes
|
|
32
|
+
|
|
33
|
+
Add any other relevant information, such as external references, related PRs, or anything you'd like the maintainers to know.
|
package/README.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
This project provides comprehensive insights into African countries, the origins of various tribes, and their geographic distributions. Built to celebrate and document Africa’s rich multicultural landscape, it allows users to explore the continent’s diverse cultural heritage, discovering the roots and locations of countless ethnic groups across Africa.
|
|
4
4
|
|
|
5
5
|
# Install
|
|
6
|
-
`npm i
|
|
6
|
+
`npm i african-states-and-tribes`
|
|
7
7
|
|
|
8
8
|
# Usage
|
|
9
9
|
|
|
@@ -16,7 +16,7 @@ This project provides comprehensive insights into African countries, the origins
|
|
|
16
16
|
- ES5 Module usage
|
|
17
17
|
|
|
18
18
|
```js
|
|
19
|
-
const africanStates = require('
|
|
19
|
+
const africanStates = require('african-states-and-tribes')
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
# Docs
|
package/SECURITY.md
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "african-states-and-tribes",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.3",
|
|
4
4
|
"description": "This project provides comprehensive insights into African countries, the origins of various tribes, and their geographic distributions. Built to celebrate and document Africa’s rich multicultural landscape, it allows users to explore the continent’s diverse cultural heritage, discovering the roots and locations of countless ethnic groups across Africa.",
|
|
5
5
|
"main": "./dist/index.js",
|
|
6
6
|
"module": "./dist/index.mjs",
|
package/docs/CONTRIBUTING
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
## Contributing Guide
|