PaloAltoNetworks / pan-os-python

The PAN-OS SDK for Python is a package to help interact with Palo Alto Networks devices (including physical and virtualized Next-generation Firewalls and Panorama). The pan-os-python SDK is object oriented and mimics the traditional interaction with the device via the GUI or CLI/API.
https://pan-os-python.readthedocs.io
ISC License
347 stars 172 forks source link

add members to automodule for Sphinx to pickup docstrings #576

Closed DctrG closed 1 month ago

DctrG commented 1 month ago

Description

Added ":members:" to module-*.rst files.

Motivation and Context

The current documentation is missing the docstrings from the classes in the modules, it shows only the docstring from the module itself which is not useful for the module users.

How Has This Been Tested?

I run "make docs" for Sphinx to crate the docs and verified that the docstrings are now populated.

Screenshots (if appropriate)

This is what the current documentation shows:

class-reference-current

This is what it will show with the changes:

class-reference-change

Types of changes

Checklist

da110us commented 1 month ago

Finally! Thank you!!