Spaces:
Runtime error
Runtime error
Asaad Almutareb
commited on
Commit
•
5b834d1
1
Parent(s):
388bfee
added contribution instructions and issue template for better collaboration
Browse files- CONTRIBUTION.md +36 -0
- .github/issue_template.md +34 -0
CONTRIBUTION.md
ADDED
@@ -0,0 +1,36 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
# Contributing to The Project
|
2 |
+
|
3 |
+
We welcome contributions from everyone. To make the process as smooth as possible, please follow the guidelines below.
|
4 |
+
|
5 |
+
## How to Contribute
|
6 |
+
|
7 |
+
### Code Contributions
|
8 |
+
|
9 |
+
1. **Creating a Branch**: For any code contribution, start by creating a branch from the main project. The branch should be named using the pattern `#issue-id short-name-to-describe-what-is-added`. This helps in linking the contributions directly to the issues they are meant to resolve.
|
10 |
+
|
11 |
+
2. **Pull Requests**: Once you've made your changes, create a pull request (PR). Please fill out the pull request template with all the required information. This includes a summary of your changes and why they are necessary.
|
12 |
+
|
13 |
+
3. **Review Process**: Every code contribution requires a review. A minimum of one maintainer must review and approve your contribution before it can be merged. This ensures quality and adherence to the project's standards. Please ensure your code is well-documented through comments and, if necessary, additional documentation files.
|
14 |
+
|
15 |
+
4. **Testing**: Your code must be tested to ensure it works as expected and does not introduce new issues.
|
16 |
+
|
17 |
+
### Reporting Issues
|
18 |
+
|
19 |
+
When reporting issues, please use the provided issue template. Your report should include:
|
20 |
+
|
21 |
+
- A clear, descriptive title
|
22 |
+
- A detailed description of the issue
|
23 |
+
- Steps to reproduce the issue
|
24 |
+
- Logs, if applicable
|
25 |
+
- Screenshots, if applicable
|
26 |
+
|
27 |
+
This information is crucial in diagnosing and fixing the issue you're experiencing.
|
28 |
+
|
29 |
+
### Suggestions
|
30 |
+
|
31 |
+
We're always looking for new ideas to improve our project. If you have a suggestion, please:
|
32 |
+
|
33 |
+
- Clearly describe your suggestion, including the purpose and intended outcome.
|
34 |
+
- Explain why you believe this change would be beneficial to the project.
|
35 |
+
|
36 |
+
We appreciate your contributions and look forward to collaborating with you!
|
.github/issue_template.md
ADDED
@@ -0,0 +1,34 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
# Issue Template for LLM + RAG Applications
|
2 |
+
|
3 |
+
## Description
|
4 |
+
Please provide a clear and concise description of the issue. Include what you expected to happen versus what actually happened. If the issue is related to retrieval results or generative outputs, specify the discrepancies.
|
5 |
+
|
6 |
+
## Steps to Reproduce
|
7 |
+
1. Detail the exact steps to reproduce the problem. Include any specific inputs given to the system.
|
8 |
+
2.
|
9 |
+
3.
|
10 |
+
(Continue as needed)
|
11 |
+
|
12 |
+
## Expected vs. Actual Results
|
13 |
+
- **Expected Results**: Describe what you expected to happen.
|
14 |
+
- **Actual Results**: Detail what actually happened, including any unexpected outputs or errors.
|
15 |
+
|
16 |
+
## Environment
|
17 |
+
- Application version:
|
18 |
+
- LLM model version:
|
19 |
+
- RAG component (if applicable):
|
20 |
+
- OS:
|
21 |
+
- Additional tools/libraries:
|
22 |
+
|
23 |
+
## Query or Input Details
|
24 |
+
- **Input Query/Text**: Provide the exact text or input given to the system.
|
25 |
+
- **Retrieval Source(s)**: Specify the datasets or sources queried by the RAG component, if relevant.
|
26 |
+
|
27 |
+
## Logs and Error Messages
|
28 |
+
Please include any relevant logs, error messages, or stack traces that could help diagnose the issue.
|
29 |
+
|
30 |
+
## Screenshots
|
31 |
+
If applicable, add screenshots to help explain the issue, especially if it involves UI elements.
|
32 |
+
|
33 |
+
## Additional Context
|
34 |
+
Add any other context about the problem here, such as specific configurations of the LLM or RAG components that might be relevant.
|