mirror of https://github.com/ansible/ansible.git
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
127 lines
4.0 KiB
YAML
127 lines
4.0 KiB
YAML
---
|
|
name: 📝 Documentation Report
|
|
description: Ask us about docs
|
|
|
|
body:
|
|
- type: markdown
|
|
attributes:
|
|
value: |
|
|
⚠
|
|
Verify first that your issue is not [already reported on GitHub][issue search].
|
|
Also test if the latest release and devel branch are affected too.
|
|
*Complete **all** sections as described, this form is processed automatically.*
|
|
|
|
[issue search]: https://github.com/ansible/ansible/search?q=is%3Aissue&type=issues
|
|
|
|
|
|
- type: textarea
|
|
attributes:
|
|
label: Summary
|
|
description: |
|
|
Explain the problem briefly below, add suggestions to wording or structure.
|
|
|
|
**HINT:** Did you know the documentation has an `Edit on GitHub` link on every page?
|
|
placeholder: >-
|
|
I was reading the ansible-core documentation of version X and I'm having
|
|
problems understanding Y. It would be very helpful if that got
|
|
rephrased as Z.
|
|
validations:
|
|
required: true
|
|
|
|
- type: dropdown
|
|
attributes:
|
|
label: Issue Type
|
|
# FIXME: Once GitHub allows defining the default choice, update this
|
|
options:
|
|
- Documentation Report
|
|
validations:
|
|
required: true
|
|
|
|
- type: input
|
|
attributes:
|
|
label: Component Name
|
|
description: >-
|
|
Write the short name of the rst file, module, plugin, task or
|
|
feature below, *use your best guess if unsure*.
|
|
placeholder: docs/docsite/rst/dev_guide/debugging.rst
|
|
validations:
|
|
required: true
|
|
|
|
- type: textarea
|
|
attributes:
|
|
label: Ansible Version
|
|
description: >-
|
|
Paste verbatim output from `ansible --version` below, under
|
|
the prompt line. Please don't wrap it with tripple backticks.
|
|
render: console
|
|
value: |
|
|
$ ansible --version
|
|
placeholder: |
|
|
$ ansible --version
|
|
ansible [core 2.11.0b4.post0] (detached HEAD ref: refs/) last updated 2021/04/02 00:33:35 (GMT +200)
|
|
config file = None
|
|
configured module search path = ['~/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']
|
|
ansible python module location = ~/src/github/ansible/ansible/lib/ansible
|
|
ansible collection location = ~/.ansible/collections:/usr/share/ansible/collections
|
|
executable location = bin/ansible
|
|
python version = 3.9.0 (default, Oct 26 2020, 13:08:59) [GCC 10.2.0]
|
|
jinja version = 2.11.3
|
|
libyaml = True
|
|
validations:
|
|
required: true
|
|
|
|
- type: textarea
|
|
attributes:
|
|
label: Configuration
|
|
description: >-
|
|
Paste verbatim output from `ansible-config dump --only-changed`
|
|
below, under the prompt line.
|
|
Please don't wrap it with tripple backticks.
|
|
render: console
|
|
value: |
|
|
$ ansible-config dump --only-changed
|
|
placeholder: |
|
|
$ ansible-config dump --only-changed
|
|
DEFAULT_GATHERING(~/src/github/ansible/ansible/ansible.cfg) = smart
|
|
DEFAULT_HOST_LIST(~/src/github/ansible/ansible/ansible.cfg) = ['~/src/github/ansible/ansible/hosts']
|
|
DEFAULT_VAULT_PASSWORD_FILE(~/src/github/ansible/ansible/ansible.cfg) = ~/src/github/ansible/ansible/vault/print-password.sh
|
|
validations:
|
|
required: true
|
|
|
|
- type: textarea
|
|
attributes:
|
|
label: OS / Environment
|
|
description: >-
|
|
Provide all relevant information below, e.g. OS version,
|
|
browser, etc.
|
|
placeholder: Fedora 33, Firefox etc.
|
|
validations:
|
|
required: true
|
|
|
|
|
|
- type: textarea
|
|
attributes:
|
|
label: Additional Information
|
|
description: |
|
|
Describe how this improves the documentation, e.g. before/after situation or screenshots.
|
|
|
|
**HINT:** You can paste https://gist.github.com links for larger files.
|
|
placeholder: >-
|
|
When the improvement is applied, it makes it more straightforward
|
|
to understand X.
|
|
validations:
|
|
required: true
|
|
|
|
|
|
- type: checkboxes
|
|
attributes:
|
|
label: Code of Conduct
|
|
description: |
|
|
Read the [Ansible Code of Conduct][CoC] first.
|
|
|
|
[CoC]: https://docs.ansible.com/ansible/latest/community/code_of_conduct.html?utm_medium=github&utm_source=issue_form--documentation_report.yml
|
|
options:
|
|
- label: I agree to follow the Ansible Code of Conduct
|
|
required: true
|
|
...
|