search

Azure / azure-sdk-for-python

This repository is for active development of the Azure SDK for Python. For consumers of the SDK we recommend visiting our public developer docs at https://docs.microsoft.com/python/azure/ or our versioned developer docs at https://azure.github.io/azure-sdk-for-python.
MIT License
4.38k stars 2.71k forks source link

Python Azure Resource Management models reference do not render. #34305

Open oakhan3 opened 5 months ago

oakhan3 commented 5 months ago

Type of issue

Missing information

Description

The Python Azure Resource Management models reference do not render. Instead all pages show a blank page for models Module.

image image

Page URL

https://learn.microsoft.com/en-us/python/api/azure-mgmt-resource/azure.mgmt.resource.deploymentscripts.models?view=azure-python

Content source URL

https://github.com/MicrosoftDocs/azure-docs-sdk-python/blob/main/docs-ref-autogen/azure-mgmt-resource/azure.mgmt.resource.deploymentscripts.models.yml

Document Version Independent Id

f2c01917-6dcd-f0ab-34be-07c0aea5576b

Article author

@lmazuel

Metadata

github-actions[bot] commented 5 months ago

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @armleads-azure.

pvaneck commented 5 months ago

Thanks for the feedback. Not sure why the docs are rendering like that. @msyyc, @rohit-ganguly perhaps one of you might know?

rohit-ganguly commented 4 months ago

Hi Paul, thanks for the tag, we have a duplicate issue in #34344 as well. @danieljurek do you have any ideas on where to start?

danieljurek commented 4 months ago

I see 3 potential causes:

  1. the docs need to be built with inheritance turned on... we've done this for client packages but have not needed to do this for management packages yet. @pvaneck do you know if this mgmt packages uses inheritance in the same way that our client packages do?
  2. An issue in the docs build for which erasing the relevant package might alleviate (I can test this if this package doesn't use inheritance)
  3. A bug in the docs build system that requires the docs team to fix (technically item 2 in this list falls into this category but we can try mitigations on our end first)