Asaad Almutareb commited on
Commit
5b834d1
1 Parent(s): 388bfee

added contribution instructions and issue template for better collaboration

Browse files
Files changed (2) hide show
  1. CONTRIBUTION.md +36 -0
  2. .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.