name: Documentation Issue
description: Report missing, incorrect, or unclear documentation
title: "[Docs]: "
labels: ["documentation", "triage"]
body:
- type: markdown
attributes:
value: |
Thanks for helping improve our documentation! Clear docs are essential for a good user experience.
- type: dropdown
id: doc-type
attributes:
label: Documentation Type
description: What type of documentation needs improvement?
options:
- API documentation (docs.rs)
- User guide / tutorial
- Example code
- README
- Code comments
- CLI documentation
- Other
validations:
required: true
- type: dropdown
id: issue-type
attributes:
label: Issue Type
description: What's the problem with the documentation?
options:
- Missing documentation
- Incorrect/outdated information
- Unclear explanation
- Broken link
- Typo/grammar
- Code example doesn't work
- Other
validations:
required: true
- type: input
id: location
attributes:
label: Location
description: Where is the documentation issue? (URL, file path, or module name)
placeholder: "https://docs.rs/velociplot/... or src/plots/line.rs or README.md"
validations:
required: true
- type: textarea
id: problem
attributes:
label: What's Wrong?
description: Describe the issue with the current documentation.
placeholder: |
The documentation says... but it should say...
or
There's no documentation for...
validations:
required: true
- type: textarea
id: suggestion
attributes:
label: Suggested Improvement
description: How would you improve the documentation?
placeholder: |
Add a section explaining...
Change "..." to "..."
Add an example showing...
validations:
required: false
- type: textarea
id: context
attributes:
label: Additional Context
description: Any other information that might help (screenshots, related docs, etc.)
placeholder: |
Other libraries document this as...
I was trying to... and couldn't find docs on...
validations:
required: false
- type: checkboxes
id: willing-to-help
attributes:
label: Contribution
description: Would you be willing to help improve this documentation?
options:
- label: I'd be willing to submit a PR to fix this
required: false
- type: checkboxes
id: terms
attributes:
label: Code of Conduct
description: By submitting this issue, you agree to follow our Code of Conduct
options:
- label: I agree to follow this project's Code of Conduct
required: true