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 the
        [Material for MkDocs 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.
        [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 link the specific sections of [our documentation](https://squidfunk.github.io/mkdocs-material)
        you described above. If applicable, add screenshots of this specific
        section.
        [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 containing the issue
        number.
        [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