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://learn.microsoft.com/python/azure/ or our versioned developer docs at https://azure.github.io/azure-sdk-for-python.
MIT License
4.57k stars 2.79k forks source link

Azure SDK Python mgmt packages overview page needs services.md #24395

Closed navba-MSFT closed 5 months ago

navba-MSFT commented 2 years ago

Describe the bug Most of mgmt packages explained here doesn't have service.md file here due to which it results in empty page.

Example for mgmt packages where Services.md file is missing causing a blank page to be displayed: Automation Overview: https://docs.microsoft.com/en-us/python/api/overview/azure/automation?view=azure-python Container Instances Overview: https://docs.microsoft.com/en-us/python/api/overview/azure/containerinstances?view=azure-python Data Explorer: https://docs.microsoft.com/en-us/python/api/overview/azure/dataexplorer?view=azure-python Data Share: https://docs.microsoft.com/en-us/python/api/overview/azure/datashare?view=azure-python Private DNS: https://docs.microsoft.com/en-us/python/api/overview/azure/privatedns?view=azure-python

Please create the services.md file here so that we don't see blank pages in above links. These documentations should be fixed.

Note: I have listed only a few. There are many packages whose Overview page gives empty content.

Examples where the services.md is present and able to show the content: Azure Storage: https://docs.microsoft.com/en-us/python/api/overview/azure/storage?view=azure-python Compute: https://docs.microsoft.com/en-us/python/api/overview/azure/compute?view=azure-python Container Registry: https://docs.microsoft.com/en-us/python/api/overview/azure/container-registry?view=azure-python DevTest Labs: https://docs.microsoft.com/en-us/python/api/overview/azure/devtest-labs?view=azure-python

Expected behavior The documents should load the contents instead of showing blank page.

Screenshots Some of the docs whose Overview contents are missing:

image

Some of the docs where the Overview contents are loading just fine:

image

Additional context Add any other context about the problem here.

github-actions[bot] commented 5 months ago

Hi @navba-MSFT, we deeply appreciate your input into this project. Regrettably, this issue has remained unresolved for over 2 years and inactive for 30 days, leading us to the decision to close it. We've implemented this policy to maintain the relevance of our issue queue and facilitate easier navigation for new contributors. If you still believe this topic requires attention, please feel free to create a new issue, referencing this one. Thank you for your understanding and ongoing support.