Index Creation Bugfixes

doc/sphinx/generate_doc.py

@@ -70,6 +70,7 @@ def make_title(title):
 # Update the code to compute this list automatically
 MULTIAPI_VERSION_NAMESPACE = [
     "azure.mgmt.storage",
+    "azure.mgmt.web",
     "azure.mgmt.network",
     "azure.mgmt.compute",
     "azure.mgmt.containerregistry",

doc/sphinx/generate_versioned_index.py

@@ -155,7 +155,7 @@ def write_toc_tree(categorized_menu_items):
 
 
 def get_categorized_menu_items(package_names):
-    categorized_menu_items = {}
+    categorized_menu_items = {"Other": {"Client":[], "Management":[], "Other": []}}
 
     for pkg in package_names:
         # add to the categorized menu items

doc/sphinx/index.rst

@@ -2,7 +2,7 @@
 Azure SDK for Python
 ====================
 
-.. important:: The most part of this documentation has moved to https://docs.microsoft.com/python/azure
+.. important:: You can find all of the Python on Azure documentation at https://docs.microsoft.com/python/azure
 
 The Azure SDK for Python is a set of libraries which allow you to work on Azure for your management, runtime or data needs.
 
@@ -59,14 +59,6 @@ If you encounter any bugs with the library please file an issue in the
 `Issues <https://github.com/Azure/azure-sdk-for-python/issues>`__
 section of the project.
 
-
-Indices and tables
-------------------
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
-
 .. toctree::
   :glob:
   :caption: User Documentation

doc/sphinx/package_service_mapping.json

@@ -811,11 +811,16 @@
   "azure-mgmt-web": {
     "category": "Management",
     "namespaces": [
-      "azure.mgmt.web"
+      "azure.mgmt.web.v2015_04_01",
+      "azure.mgmt.web.v2015_08_01",
+      "azure.mgmt.web.v2016_03_01",
+      "azure.mgmt.web.v2016_08_01",
+      "azure.mgmt.web.v2016_09_01",
+      "azure.mgmt.web.v2018_02_01",
+      "azure.mgmt.web.v2018_11_01"
     ],
     "service_name": "Web Apps"
   },
-
   "azure-servicebus": {
     "category": "Client",
     "service_name": "Service Bus",
@@ -991,7 +996,7 @@
   },
   "azure-mgmt-storagesync": {
     "category": "Management",
-    "service_name": "Storage",
+    "service_name": "Storage Sync",
     "namespaces": [
       "azure.mgmt.storagesync"
     ]

doc/sphinx/servicemanagement.rst

@@ -116,9 +116,9 @@ To make a new deployment to Azure you must store the package file in a
 Microsoft Azure Blob Storage account under the same subscription as the
 hosted service to which the package is being uploaded. You can create a
 deployment package with the `Microsoft Azure PowerShell
-cmdlets <https://www.windowsazure.com/en-us/develop/php/how-to-guides/powershell-cmdlets/>`__,
+cmdlets <https://docs.microsoft.com/en-us/powershell/azure/?view=azps-3.2.0>`__,
 or with the `cspack commandline
-tool <http://msdn.microsoft.com/en-us/library/gg432988.aspx>`__.
+tool <https://docs.microsoft.com/en-us/azure/cloud-services/cloud-services-model-and-package#servicepackagecspkg>`__.
 
 .. code:: python
 

eng/pipelines/create-doc-index.yml

@@ -27,10 +27,17 @@ jobs:
         inputs:
           versionSpec: $(PythonVersion)
 
+      - template: eng/pipelines/templates/scripts/replace-relative-links.yml@azure-sdk-tools
+        parameters:
+          TargetFolder: '.'
+          RootFolder: '.'
+          BuildSHA: $(Build.SourceVersion)
+          RepoId: 'Azure/azure-sdk-for-python'
+
       - pwsh: |
           pip install -r $(Build.SourcesDirectory)/doc/sphinx/requirements.txt
           python $(Build.SourcesDirectory)/doc/sphinx/generate_versioned_index.py
-          mkdir $(Build.ArtifactStagingDirectory)
+          sphinx-build -b html -c $(Build.SourcesDirectory)/doc/sphinx $(Build.SourcesDirectory)/_docs $(Build.SourcesDirectory)/_docs/html
           Copy-Item -Path $(Build.SourcesDirectory)/_docs/html/* -Destination $(Build.ArtifactStagingDirectory) -Recurse -Force
         displayName: 'Generate Documentation Index'