Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Panos/doc fragment #37696

Merged
merged 4 commits into from
May 9, 2018
Merged

Panos/doc fragment #37696

merged 4 commits into from
May 9, 2018

Conversation

kbreit
Copy link
Contributor

@kbreit kbreit commented Mar 21, 2018

SUMMARY

Many of the PanOS modules have duplicate documentation. This pull request’s goal is to summarize documentation, where possible, in a documentation fragment instead of in the module itself.

ISSUE TYPE
  • Docs Pull Request
COMPONENT NAME

panos_admin

This affects other modules as well

ANSIBLE VERSION
ansible 2.4.2.0
  config file = /etc/ansible/ansible.cfg
  configured module search path = [u'/home/kbreit/.ansible/plugins/modules', u'/usr/share/ansible/plugins/modules']
  ansible python module location = /usr/lib/python2.7/site-packages/ansible
  executable location = /usr/bin/ansible
  python version = 2.7.5 (default, Aug  4 2017, 00:39:18) [GCC 4.8.5 20150623 (Red Hat 4.8.5-16)]
ADDITIONAL INFORMATION

Not all modules are affected by this change. If a documentation fragment should exist only when all modules in a family can use it, it likely makes sense to cancel this PR.

@ansibot
Copy link
Contributor

ansibot commented Mar 21, 2018

@ansibot ansibot added core_review In order to be merged, this PR must follow the core review workflow. docs This issue/PR relates to or includes documentation. module This issue/PR relates to a module. needs_triage Needs a first human triage before being processed. networking Network category support:community This issue/PR relates to code supported by the Ansible community. support:core This issue/PR relates to code supported by the Ansible Engineering Team. labels Mar 21, 2018
@ansibot
Copy link
Contributor

ansibot commented Mar 21, 2018

The test ansible-test sanity --test pylint [explain] failed with 1 error:

lib/ansible/utils/module_docs_fragments/panos.py:26:0: trailing-newlines Trailing newlines

The test ansible-test sanity --test ansible-doc --python 2.6 [explain] failed with 2 errors:

lib/ansible/modules/network/panos/panos_interface.py:0:0: has a documentation error formatting or is missing documentation.
lib/ansible/modules/network/panos/panos_mgtconfig.py:0:0: has a documentation error formatting or is missing documentation.

The test ansible-test sanity --test ansible-doc --python 3.5 [explain] failed with 2 errors:

lib/ansible/modules/network/panos/panos_interface.py:0:0: has a documentation error formatting or is missing documentation.
lib/ansible/modules/network/panos/panos_mgtconfig.py:0:0: has a documentation error formatting or is missing documentation.

The test ansible-test sanity --test ansible-doc --python 3.6 [explain] failed with 2 errors:

lib/ansible/modules/network/panos/panos_interface.py:0:0: has a documentation error formatting or is missing documentation.
lib/ansible/modules/network/panos/panos_mgtconfig.py:0:0: has a documentation error formatting or is missing documentation.

The test ansible-test sanity --test ansible-doc --python 3.7 [explain] failed with 2 errors:

lib/ansible/modules/network/panos/panos_interface.py:0:0: has a documentation error formatting or is missing documentation.
lib/ansible/modules/network/panos/panos_mgtconfig.py:0:0: has a documentation error formatting or is missing documentation.

The test ansible-test sanity --test ansible-doc --python 2.7 [explain] failed with 2 errors:

lib/ansible/modules/network/panos/panos_interface.py:0:0: has a documentation error formatting or is missing documentation.
lib/ansible/modules/network/panos/panos_mgtconfig.py:0:0: has a documentation error formatting or is missing documentation.

The test ansible-test sanity --test pep8 [explain] failed with 1 error:

lib/ansible/utils/module_docs_fragments/panos.py:26:1: W391 blank line at end of file

The test ansible-test sanity --test validate-modules [explain] failed with 8 errors:

lib/ansible/modules/network/panos/panos_interface.py:0:0: E324 Value for "default" from the argument_spec ('admin') for "username" does not match the documentation (None)
lib/ansible/modules/network/panos/panos_interface.py:0:0: E324 Value for "default" from the argument_spec (False) for "create_default_route" does not match the documentation (None)
lib/ansible/modules/network/panos/panos_interface.py:0:0: E324 Value for "default" from the argument_spec (True) for "commit" does not match the documentation (None)
lib/ansible/modules/network/panos/panos_interface.py:41:5: E302 DOCUMENTATION is not valid YAML
lib/ansible/modules/network/panos/panos_mgtconfig.py:0:0: E324 Value for "default" from the argument_spec ('admin') for "username" does not match the documentation (None)
lib/ansible/modules/network/panos/panos_mgtconfig.py:0:0: E324 Value for "default" from the argument_spec (True) for "commit" does not match the documentation (None)
lib/ansible/modules/network/panos/panos_mgtconfig.py:0:0: E325 argument_spec for "commit" defines type="bool" but documentation does not
lib/ansible/modules/network/panos/panos_mgtconfig.py:34:5: E302 DOCUMENTATION is not valid YAML

The test ansible-test sanity --test yamllint [explain] failed with 2 errors:

lib/ansible/modules/network/panos/panos_interface.py:41:5: error DOCUMENTATION: syntax error: expected <block end>, but found '<block mapping start>'
lib/ansible/modules/network/panos/panos_mgtconfig.py:34:5: error DOCUMENTATION: syntax error: expected <block end>, but found '<block mapping start>'

click here for bot help

@ansibot ansibot added ci_verified Changes made in this PR are causing tests to fail. needs_revision This PR fails CI tests or a maintainer has requested a review/revision of the PR. core_review In order to be merged, this PR must follow the core review workflow. and removed core_review In order to be merged, this PR must follow the core review workflow. ci_verified Changes made in this PR are causing tests to fail. needs_revision This PR fails CI tests or a maintainer has requested a review/revision of the PR. labels Mar 21, 2018
@samdoran samdoran removed the needs_triage Needs a first human triage before being processed. label Mar 22, 2018
@acozine acozine moved this from Docsite work to Module docs maintenance in Ansible-maintained Collections Documentation Mar 28, 2018
@acozine acozine moved this from Module docs maintenance to In progress in Ansible-maintained Collections Documentation Mar 28, 2018
@ansibot ansibot added the stale_ci This PR has been tested by CI more than one week ago. Close and re-open this PR to get it retested. label Mar 30, 2018
@kbreit
Copy link
Contributor Author

kbreit commented Apr 2, 2018

What is needed for this to be merged?

@acozine acozine moved this from In progress to Community Modules Maintenance in Ansible-maintained Collections Documentation Apr 4, 2018
@ansibot ansibot added needs_rebase https://docs.ansible.com/ansible/devel/dev_guide/developing_rebasing.html needs_revision This PR fails CI tests or a maintainer has requested a review/revision of the PR. and removed core_review In order to be merged, this PR must follow the core review workflow. labels Apr 10, 2018
@gundalow
Copy link
Contributor

gundalow commented May 2, 2018

Can you please rebase then I'll look at getting this merged. thanks

@gundalow gundalow self-assigned this May 2, 2018
options:
ip_address:
description:
- IP address (or hostname) of PAN-OS device
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could you add a fullstop at the end of this (and other)

required: true
password:
description:
- password for authentication
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Password

required: true
username:
description:
- username for authentication
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Username

@ansibot ansibot removed the stale_ci This PR has been tested by CI more than one week ago. Close and re-open this PR to get it retested. label May 2, 2018
- Module documentation fragment currently holds 3 parameters
- It most likely won't be used in every single module since there is
some variance
kbreit added 3 commits May 2, 2018 11:42
- Where documentation is consistent, module documentation now uses a
documentation fragment instead of all documentation being contained in
the module.
Updated some formatting errors to make ansibot happy.
@ansibot ansibot added core_review In order to be merged, this PR must follow the core review workflow. and removed needs_rebase https://docs.ansible.com/ansible/devel/dev_guide/developing_rebasing.html needs_revision This PR fails CI tests or a maintainer has requested a review/revision of the PR. labels May 2, 2018
@acozine
Copy link
Contributor

acozine commented May 9, 2018

Thank you for contributing to cleaner documentation!

@acozine acozine merged commit c36aa6a into ansible:devel May 9, 2018
Ansible-maintained Collections Documentation automation moved this from Community Modules Maintenance to Done May 9, 2018
oolongbrothers pushed a commit to oolongbrothers/ansible that referenced this pull request May 12, 2018
* Create PanOS module documentation fragment

- Module documentation fragment currently holds 3 parameters
- It most likely won't be used in every single module since there is
some variance

* Modified PanOS module for use doc_frags

- Where documentation is consistent, module documentation now uses a
documentation fragment instead of all documentation being contained in
the module.

* Formatting and syntax error fixes

Updated some formatting errors to make ansibot happy.

* Revisions for grammar
oolongbrothers pushed a commit to oolongbrothers/ansible that referenced this pull request May 14, 2018
* Create PanOS module documentation fragment

- Module documentation fragment currently holds 3 parameters
- It most likely won't be used in every single module since there is
some variance

* Modified PanOS module for use doc_frags

- Where documentation is consistent, module documentation now uses a
documentation fragment instead of all documentation being contained in
the module.

* Formatting and syntax error fixes

Updated some formatting errors to make ansibot happy.

* Revisions for grammar
oolongbrothers pushed a commit to oolongbrothers/ansible that referenced this pull request May 14, 2018
* Create PanOS module documentation fragment

- Module documentation fragment currently holds 3 parameters
- It most likely won't be used in every single module since there is
some variance

* Modified PanOS module for use doc_frags

- Where documentation is consistent, module documentation now uses a
documentation fragment instead of all documentation being contained in
the module.

* Formatting and syntax error fixes

Updated some formatting errors to make ansibot happy.

* Revisions for grammar
tonal pushed a commit to tonal/ansible that referenced this pull request May 15, 2018
* Create PanOS module documentation fragment

- Module documentation fragment currently holds 3 parameters
- It most likely won't be used in every single module since there is
some variance

* Modified PanOS module for use doc_frags

- Where documentation is consistent, module documentation now uses a
documentation fragment instead of all documentation being contained in
the module.

* Formatting and syntax error fixes

Updated some formatting errors to make ansibot happy.

* Revisions for grammar
oolongbrothers pushed a commit to oolongbrothers/ansible that referenced this pull request May 15, 2018
* Create PanOS module documentation fragment

- Module documentation fragment currently holds 3 parameters
- It most likely won't be used in every single module since there is
some variance

* Modified PanOS module for use doc_frags

- Where documentation is consistent, module documentation now uses a
documentation fragment instead of all documentation being contained in
the module.

* Formatting and syntax error fixes

Updated some formatting errors to make ansibot happy.

* Revisions for grammar
oolongbrothers pushed a commit to oolongbrothers/ansible that referenced this pull request May 15, 2018
* Create PanOS module documentation fragment

- Module documentation fragment currently holds 3 parameters
- It most likely won't be used in every single module since there is
some variance

* Modified PanOS module for use doc_frags

- Where documentation is consistent, module documentation now uses a
documentation fragment instead of all documentation being contained in
the module.

* Formatting and syntax error fixes

Updated some formatting errors to make ansibot happy.

* Revisions for grammar
@kbreit kbreit deleted the panos/doc_fragment branch September 28, 2018 16:01
ilicmilan pushed a commit to ilicmilan/ansible that referenced this pull request Nov 7, 2018
* Create PanOS module documentation fragment

- Module documentation fragment currently holds 3 parameters
- It most likely won't be used in every single module since there is
some variance

* Modified PanOS module for use doc_frags

- Where documentation is consistent, module documentation now uses a
documentation fragment instead of all documentation being contained in
the module.

* Formatting and syntax error fixes

Updated some formatting errors to make ansibot happy.

* Revisions for grammar
@ansible ansible locked and limited conversation to collaborators May 9, 2019
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
core_review In order to be merged, this PR must follow the core review workflow. docs This issue/PR relates to or includes documentation. module This issue/PR relates to a module. networking Network category support:community This issue/PR relates to code supported by the Ansible community. support:core This issue/PR relates to code supported by the Ansible Engineering Team.
Projects
No open projects
Development

Successfully merging this pull request may close these issues.

None yet

5 participants