Skip to content

Commit 9510eaf

Browse files
docs: adds contributing guide and issue templates (#121)
1 parent 6d523c8 commit 9510eaf

File tree

4 files changed

+193
-33
lines changed

4 files changed

+193
-33
lines changed

.github/CONTRIBUTING.md

+60
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
# Contributing to apimatic/core-lib-java
2+
3+
Thank you for your interest in contributing! 🎉 Your contributions help make this project better. We value open-source contributions to this library, please take a few minutes to review this guide before you start.
4+
5+
---
6+
7+
## 💡 How to Contribute
8+
9+
### 📌 1. Reporting Issues
10+
11+
- Search existing issues before opening a new one.
12+
- Use a **descriptive title** and provide clear steps to reproduce.
13+
- Include relevant logs, screenshots, or error messages.
14+
15+
### 🔧 2. Making Changes
16+
17+
#### Step 1: Create a Branch
18+
19+
- Create a new branch from `master`:
20+
```sh
21+
git checkout -b your-feature-name
22+
```
23+
24+
#### Step 2: Make Your Changes
25+
26+
- Follow the project's **coding standards**.
27+
- Add **unit tests** if applicable.
28+
- Ensure your changes **do not break existing functionality**.
29+
30+
#### Step 3: Commit Changes
31+
32+
- Use clear and descriptive commit messages:
33+
```sh
34+
git commit -m "feat: Add feature description"
35+
```
36+
37+
#### Step 4: Push & Open a PR
38+
39+
- Push your branch:
40+
```sh
41+
git push origin your-feature-name
42+
```
43+
- Open a **Pull Request (PR)** on GitHub:
44+
- Provide a clear **description** of the changes.
45+
- Mention related **issue numbers**.
46+
- Request a **review** from maintainers.
47+
- Make sure your changes clear all the **PR Checks**.
48+
49+
---
50+
51+
## 📜 License
52+
53+
By contributing, you agree that your contributions will be licensed under the project's [LICENSE](LICENSE).
54+
55+
---
56+
57+
💬 **Questions?**
58+
If you need help, feel free to open issues, we will be happy to help.
59+
60+
Happy Coding! 🚀

.github/ISSUE_TEMPLATE/bug-report.md

-33
This file was deleted.

.github/ISSUE_TEMPLATE/bug-report.yml

+79
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
name: 🐞 Bug
2+
description: Report a bug or an issue you've found
3+
title: "[Bug] <title>"
4+
labels: ["bug"]
5+
body:
6+
- type: markdown
7+
attributes:
8+
value: |
9+
Thanks for taking the time to fill out this bug report!
10+
- type: checkboxes
11+
attributes:
12+
label: Is this a new bug?
13+
description: >
14+
In other words: Is this an error, flaw, failure or fault? Please search issues to see if someone has already reported the bug you encountered.
15+
options:
16+
- label: I believe this is a new bug
17+
required: true
18+
- label: I have searched the existing issues, and I could not find an existing issue for this bug
19+
required: true
20+
21+
- type: textarea
22+
attributes:
23+
label: Current Behavior
24+
description: A concise description of what you're experiencing.
25+
validations:
26+
required: true
27+
28+
- type: textarea
29+
attributes:
30+
label: Expected Behavior
31+
description: A concise description of what you expected to happen.
32+
validations:
33+
required: true
34+
35+
- type: textarea
36+
attributes:
37+
label: Steps To Reproduce
38+
description: Steps to reproduce the behavior.
39+
placeholder: |
40+
1. In this environment...
41+
2. With this config...
42+
3. Run '...'
43+
4. See error...
44+
validations:
45+
required: true
46+
47+
- type: textarea
48+
attributes:
49+
label: Environment
50+
description: |
51+
examples:
52+
- **OS**: Ubuntu 20.04
53+
- **Language version**: Java 8 (`java --version`)
54+
- **SDK Name**: PayPal (If you are using this library as a dependency, please name the parent SDK)
55+
value: |
56+
- **OS**:
57+
- **Language version**:
58+
- **SDK Name**:
59+
render: markdown
60+
validations:
61+
required: true
62+
63+
- type: textarea
64+
id: logs
65+
attributes:
66+
label: Relevant log output
67+
description: |
68+
If applicable, log output to help explain your problem.
69+
render: shell
70+
validations:
71+
required: false
72+
73+
- type: textarea
74+
attributes:
75+
label: Additional Context
76+
description: |
77+
Links? References? Anything that will give us more context about the issue you are encountering!
78+
validations:
79+
required: false
+54
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
name: ✨ Feature
2+
description: Propose a straightforward extension
3+
title: "[Feature] <title>"
4+
labels: ["enhancement"]
5+
body:
6+
- type: markdown
7+
attributes:
8+
value: |
9+
Thanks for taking the time to fill out this feature request!
10+
- type: checkboxes
11+
attributes:
12+
label: Is this your first time submitting a feature request?
13+
description: >
14+
We want to make sure that features are distinct and discoverable,
15+
so that other members of the community can find them and offer their thoughts.
16+
17+
Issues are the right place to request straightforward extensions of existing functionality.
18+
options:
19+
- label: I have searched the existing issues, and I could not find an existing issue for this feature
20+
required: true
21+
- label: I am requesting an extension of the existing functionality
22+
- type: textarea
23+
attributes:
24+
label: Describe the feature
25+
description: A clear and concise description of what you want to happen.
26+
validations:
27+
required: true
28+
- type: textarea
29+
attributes:
30+
label: Describe alternatives you've considered
31+
description: |
32+
A clear and concise description of any alternative solutions or features you've considered.
33+
validations:
34+
required: false
35+
- type: textarea
36+
attributes:
37+
label: Who will this benefit?
38+
description: |
39+
What kind of use case will this feature be useful for? Please be specific and provide examples, this will help us prioritize properly.
40+
validations:
41+
required: false
42+
- type: input
43+
attributes:
44+
label: Are you interested in contributing this feature?
45+
description: Let us know if you want to write some code, and how we can help.
46+
validations:
47+
required: false
48+
- type: textarea
49+
attributes:
50+
label: Anything else?
51+
description: |
52+
Links? References? Anything that will give us more context about the feature you are suggesting!
53+
validations:
54+
required: false

0 commit comments

Comments
 (0)