mirror of
https://github.com/imartinez/privateGPT.git
synced 2025-04-27 19:28:38 +00:00
docs: add PR and issue templates (#2002)
* chore: add pull request template * chore: add issue templates * chore: require more information in bugs
This commit is contained in:
parent
90d211c5cd
commit
2c78bb2958
105
.github/ISSUE_TEMPLATE/bug.yml
vendored
Normal file
105
.github/ISSUE_TEMPLATE/bug.yml
vendored
Normal file
@ -0,0 +1,105 @@
|
||||
name: Bug Report
|
||||
description: Report a bug or issue with the project.
|
||||
title: "[BUG] "
|
||||
labels: ["bug"]
|
||||
|
||||
body:
|
||||
- type: markdown
|
||||
attributes:
|
||||
value: |
|
||||
**Please describe the bug you encountered.**
|
||||
|
||||
- type: checkboxes
|
||||
id: pre-check
|
||||
attributes:
|
||||
label: Pre-check
|
||||
description: Please confirm that you have searched for duplicate issues before creating this one.
|
||||
options:
|
||||
- label: I have searched the existing issues and none cover this bug.
|
||||
required: true
|
||||
|
||||
- type: textarea
|
||||
id: description
|
||||
attributes:
|
||||
label: Description
|
||||
description: Provide a detailed description of the bug.
|
||||
placeholder: "Detailed description of the bug"
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: textarea
|
||||
id: steps
|
||||
attributes:
|
||||
label: Steps to Reproduce
|
||||
description: Provide the steps to reproduce the bug.
|
||||
placeholder: "1. Step one\n2. Step two\n3. Step three"
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: input
|
||||
id: expected
|
||||
attributes:
|
||||
label: Expected Behavior
|
||||
description: Describe what you expected to happen.
|
||||
placeholder: "Expected behavior"
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: input
|
||||
id: actual
|
||||
attributes:
|
||||
label: Actual Behavior
|
||||
description: Describe what actually happened.
|
||||
placeholder: "Actual behavior"
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: input
|
||||
id: environment
|
||||
attributes:
|
||||
label: Environment
|
||||
description: Provide details about your environment (e.g., OS, GPU, profile, etc.).
|
||||
placeholder: "Environment details"
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: input
|
||||
id: additional
|
||||
attributes:
|
||||
label: Additional Information
|
||||
description: Provide any additional information that may be relevant (e.g., logs, screenshots).
|
||||
placeholder: "Any additional information that may be relevant"
|
||||
|
||||
- type: input
|
||||
id: version
|
||||
attributes:
|
||||
label: Version
|
||||
description: Provide the version of the project where you encountered the bug.
|
||||
placeholder: "Version number"
|
||||
|
||||
- type: markdown
|
||||
attributes:
|
||||
value: |
|
||||
**Please ensure the following setup checklist has been reviewed before submitting the bug report.**
|
||||
|
||||
- type: checkboxes
|
||||
id: general-setup-checklist
|
||||
attributes:
|
||||
label: Setup Checklist
|
||||
description: Verify the following general aspects of your setup.
|
||||
options:
|
||||
- label: Confirm that you have followed the installation instructions in the project’s documentation.
|
||||
- label: Check that you are using the latest version of the project.
|
||||
- label: Verify disk space availability for model storage and data processing.
|
||||
- label: Ensure that you have the necessary permissions to run the project.
|
||||
|
||||
- type: checkboxes
|
||||
id: nvidia-setup-checklist
|
||||
attributes:
|
||||
label: NVIDIA GPU Setup Checklist
|
||||
description: Verify the following aspects of your NVIDIA GPU setup.
|
||||
options:
|
||||
- label: Check that the all CUDA dependencies are installed and are compatible with your GPU (refer to [CUDA's documentation](https://docs.nvidia.com/deploy/cuda-compatibility/#frequently-asked-questions))
|
||||
- label: Ensure an NVIDIA GPU is installed and recognized by the system (run `nvidia-smi` to verify).
|
||||
- label: Ensure proper permissions are set for accessing GPU resources.
|
||||
- label: Docker users - Verify that the NVIDIA Container Toolkit is configured correctly (e.g. run `sudo docker run --rm --gpus all nvidia/cuda:11.0.3-base-ubuntu20.04 nvidia-smi`)
|
8
.github/ISSUE_TEMPLATE/config.yml
vendored
Normal file
8
.github/ISSUE_TEMPLATE/config.yml
vendored
Normal file
@ -0,0 +1,8 @@
|
||||
blank_issues_enabled: false
|
||||
contact_links:
|
||||
- name: Documentation
|
||||
url: https://docs.privategpt.dev
|
||||
about: Please refer to our documentation for more details and guidance.
|
||||
- name: Discord
|
||||
url: https://discord.gg/bK6mRVpErU
|
||||
about: Join our Discord community to ask questions and get help.
|
19
.github/ISSUE_TEMPLATE/docs.yml
vendored
Normal file
19
.github/ISSUE_TEMPLATE/docs.yml
vendored
Normal file
@ -0,0 +1,19 @@
|
||||
name: Documentation
|
||||
description: Suggest a change or addition to the documentation.
|
||||
title: "[DOCS] "
|
||||
labels: ["documentation"]
|
||||
|
||||
body:
|
||||
- type: markdown
|
||||
attributes:
|
||||
value: |
|
||||
**Please describe the documentation change or addition you would like to suggest.**
|
||||
|
||||
- type: textarea
|
||||
id: description
|
||||
attributes:
|
||||
label: Description
|
||||
description: Provide a detailed description of the documentation change.
|
||||
placeholder: "Detailed description of the documentation change"
|
||||
validations:
|
||||
required: true
|
37
.github/ISSUE_TEMPLATE/feature.yml
vendored
Normal file
37
.github/ISSUE_TEMPLATE/feature.yml
vendored
Normal file
@ -0,0 +1,37 @@
|
||||
name: Enhancement
|
||||
description: Suggest an enhancement or improvement to the project.
|
||||
title: "[FEATURE] "
|
||||
labels: ["enhancement"]
|
||||
|
||||
body:
|
||||
- type: markdown
|
||||
attributes:
|
||||
value: |
|
||||
**Please describe the enhancement or improvement you would like to suggest.**
|
||||
|
||||
- type: textarea
|
||||
id: feature_description
|
||||
attributes:
|
||||
label: Feature Description
|
||||
description: Provide a detailed description of the enhancement.
|
||||
placeholder: "Detailed description of the enhancement"
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: textarea
|
||||
id: reason
|
||||
attributes:
|
||||
label: Reason
|
||||
description: Explain the reason for this enhancement.
|
||||
placeholder: "Reason for the enhancement"
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: textarea
|
||||
id: value
|
||||
attributes:
|
||||
label: Value of Feature
|
||||
description: Describe the value or benefits this feature will bring.
|
||||
placeholder: "Value or benefits of the feature"
|
||||
validations:
|
||||
required: true
|
19
.github/ISSUE_TEMPLATE/question.yml
vendored
Normal file
19
.github/ISSUE_TEMPLATE/question.yml
vendored
Normal file
@ -0,0 +1,19 @@
|
||||
name: Question
|
||||
description: Ask a question about the project.
|
||||
title: "[QUESTION] "
|
||||
labels: ["question"]
|
||||
|
||||
body:
|
||||
- type: markdown
|
||||
attributes:
|
||||
value: |
|
||||
**Please describe your question in detail.**
|
||||
|
||||
- type: textarea
|
||||
id: question
|
||||
attributes:
|
||||
label: Question
|
||||
description: Provide a detailed description of your question.
|
||||
placeholder: "Detailed description of the question"
|
||||
validations:
|
||||
required: true
|
37
.github/pull_request_template.md
vendored
Normal file
37
.github/pull_request_template.md
vendored
Normal file
@ -0,0 +1,37 @@
|
||||
# Description
|
||||
|
||||
Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context. List any dependencies that are required for this change.
|
||||
|
||||
## Type of Change
|
||||
|
||||
Please delete options that are not relevant.
|
||||
|
||||
- [ ] Bug fix (non-breaking change which fixes an issue)
|
||||
- [ ] New feature (non-breaking change which adds functionality)
|
||||
- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
|
||||
- [ ] This change requires a documentation update
|
||||
|
||||
## How Has This Been Tested?
|
||||
|
||||
Please describe the tests that you ran to verify your changes. Provide instructions so we can reproduce. Please also list any relevant details for your test configuration
|
||||
|
||||
- [ ] Added new unit/integration tests
|
||||
- [ ] I stared at the code and made sure it makes sense
|
||||
|
||||
**Test Configuration**:
|
||||
* Firmware version:
|
||||
* Hardware:
|
||||
* Toolchain:
|
||||
* SDK:
|
||||
|
||||
## Checklist:
|
||||
|
||||
- [ ] My code follows the style guidelines of this project
|
||||
- [ ] I have performed a self-review of my code
|
||||
- [ ] I have commented my code, particularly in hard-to-understand areas
|
||||
- [ ] I have made corresponding changes to the documentation
|
||||
- [ ] My changes generate no new warnings
|
||||
- [ ] I have added tests that prove my fix is effective or that my feature works
|
||||
- [ ] New and existing unit tests pass locally with my changes
|
||||
- [ ] Any dependent changes have been merged and published in downstream modules
|
||||
- [ ] I ran `make check; make test` to ensure mypy and tests pass
|
Loading…
Reference in New Issue
Block a user