mkdocs-material/.github/ISSUE_TEMPLATE/02-report-a-docs-issue.yml
2023-01-29 20:35:35 +01:00

66 lines
2.9 KiB
YAML

name: Report a docs issue
description: Missing information in our docs? Create a documentation issue
labels:
- documentation
body:
- type: textarea
id: description
attributes:
label: Description
description: >-
Please describe the inconsistency or issue you have found in
[our documentation](https://squidfunk.github.io/mkdocs-material)
or indicate where you feel there is a need for improvement. Furthermore,
explain the severity of the issue, i.e., it's impact on you and potentially
other users.
[More](https://squidfunk.github.io/mkdocs-material/contributing/reporting-a-docs-issue/#description)
validations:
required: true
- type: textarea
id: related-links
attributes:
label: Related links
description: >-
Please list all links to the sections of [our documentation](https://squidfunk.github.io/mkdocs-material)
that are impacted by the issue you described above. If applicable,
add screenshots. Additionally, list links to possibly related open
and closed [issues](https://github.com/squidfunk/mkdocs-material/issues)
or [discussions](https://github.com/squidfunk/mkdocs-material/discussions)
you encountered when searching our issue tracker.
[More](https://squidfunk.github.io/mkdocs-material/contributing/reporting-a-docs-issue/#related-links)
value: |-
- [Reporting a docs issue](https://squidfunk.github.io/mkdocs-material/contributing/reporting-a-docs-issue/)
-
validations:
required: true
- type: textarea
id: proposed-change
attributes:
label: Proposed change
description: >-
This field is optional. You may provide an improvement proposal for our
documentation by describing your suggestion in the text field below or
creating a pull request after reporting this issue referencing the issue.
[More](https://squidfunk.github.io/mkdocs-material/contributing/reporting-a-docs-issue/#proposed-change)
- type: checkboxes
id: checklist
attributes:
label: Before submitting
description: >-
Please ensure your documentation issue report fulfills all of the
following requirements. If you need clarification on a specific
requirement, follow the link to learn about it and understand why it is
necessary before ticking the box. This will save the maintainers and you
valuable time.
options:
- label: >-
I have read and followed the [docs issue reporting guidelines](https://squidfunk.github.io/mkdocs-material/contributing/reporting-a-docs-issue/).
required: true
- label: >-
I have attached the links to the described sections of [the documentation](https://squidfunk.github.io/mkdocs-material/contributing/reporting-a-docs-issue/#related-links)
required: true