search

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

Documentation is broken #542

Closed jogueber closed 5 months ago

jogueber commented 10 months ago

Documentation rending broken!

Seems to be a rendering issue

https://pan-os-python.readthedocs.io/en/latest/module-firewall.html

jogueber commented 10 months ago

Bug

F1p commented 9 months ago

Any update? It's annoying

da110us commented 8 months ago

Workaround is to select the 'stable' version (instead of 'Latest'). Bottom right corner.

Hanyang-Luo commented 7 months ago

Now the stable version is also not rendering for me. Does anyone else have similar issues? Any work around?

nikolay-matveev-kkr commented 7 months ago

Same here… The stable branch was the workaound, and now it’s gone too.

From: Hanyang-Luo @.> Sent: Wednesday, April 24, 2024 7:10 PM To: PaloAltoNetworks/pan-os-python @.> Cc: Subscribed @.***> Subject: Re: [PaloAltoNetworks/pan-os-python] Documentation is broken (Issue #542)

Now the stable version is also not rendering for me. Does anyone else have similar issues? Any work around? — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you are subscribed to this thread. Message

Now the stable version is also not rendering for me. Does anyone else have similar issues? Any work around?

— Reply to this email directly, view it on GitHubhttps://urldefense.com/v3/__https:/github.com/PaloAltoNetworks/pan-os-python/issues/542*issuecomment-2075544735__;Iw!!HWWtag!wwI0aDqJntl1FobVa2_lBi4sNozyuuzqjxgLgbZ9mVD9YL0yAjKXShNTXaAuRexDxtcbkO-5YnmKBnDQ2Z8no-iR4rGd$, or unsubscribehttps://urldefense.com/v3/__https:/github.com/notifications/unsubscribe-auth/AYBODG6KXTKQCITWQWBHYD3Y67YQPAVCNFSM6AAAAABCAICTW6VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDANZVGU2DINZTGU__;!!HWWtag!wwI0aDqJntl1FobVa2_lBi4sNozyuuzqjxgLgbZ9mVD9YL0yAjKXShNTXaAuRexDxtcbkO-5YnmKBnDQ2Z8noyT5i22J$. You are receiving this because you are subscribed to this thread.Message ID: @.**@.>>

=============================================================================== Please refer to http://www.kkr.com/email-disclaimer for important disclosures regarding this electronic communication. KKR uses your personal information in accordance with its privacy notices, which can be found on http://www.kkr.com.

Hanyang-Luo commented 7 months ago

The work around I found right now is to look into the source code. I am guessing how readTheDocs render the doc is by extracting the text string in each method. For example, I want to lookup the function "refresh_devices()" under panorama object. I can find the specification of input and output in the funciton header.

image

It is annoying that we can't find all the method documentation in one place but this is better than nothing.

jamesholland-uk commented 6 months ago

Hi everyone, apologies for the current issue with the docs. Just to let you know that the team are aware of the issue and will be progressing a fix as soon as possible

freiermuth commented 5 months ago

This isn't closed? it's still an issue

BatD2 commented 5 months ago

Still not working - neither for latest, nor for stable release

btorresgil commented 5 months ago

Fixed and deployed. Sorry this took so long.

BatD2 commented 4 months ago

@btorresgil It still seems to not be fully working. It shows the relational diagrams, but missing the actual description of each object.

Hanyang-Luo commented 4 months ago

I am experiencing the same issue. The detail documentation of object, methods, and class were not accessible.