diff --git a/docfx.json b/docfx.json
index ebcd91dc05d0..66ba0d0401fb 100644
--- a/docfx.json
+++ b/docfx.json
@@ -8,7 +8,8 @@
         ],
         "src": "docs-ref-services/latest",
         "group": "latest",
-        "dest": "api/overview/azure"
+        "dest": "api/overview/azure",
+        "exclude": [ "**/*-index.md" ]
       },
       {
         "files": [
@@ -17,7 +18,8 @@
         ],
         "src": "docs-ref-services/preview",
         "group": "preview",
-        "dest": "api/overview/azure"
+        "dest": "api/overview/azure",
+        "exclude": [ "**/*-index.md" ]
       },
       {
         "files": [
@@ -26,7 +28,8 @@
         ],
         "src": "docs-ref-services/legacy",
         "group": "previous",
-        "dest": "api/overview/azure"
+        "dest": "api/overview/azure",
+        "exclude": [ "**/*-index.md" ]
       },
       {
         "files": [
@@ -35,7 +38,8 @@
         ],
         "src": "docs-ref-services",
         "group": "all",
-        "dest": "api/overview/azure"
+        "dest": "api/overview/azure",
+        "exclude": [ "*-index.md" ]
       },
       {
         "files": [
diff --git a/docs-ref-services/latest/data-lake-storage-(gen-1)-index.md b/docs-ref-services/latest/data-lake-storage-gen-1-index.md
similarity index 100%
rename from docs-ref-services/latest/data-lake-storage-(gen-1)-index.md
rename to docs-ref-services/latest/data-lake-storage-gen-1-index.md
diff --git a/docs-ref-services/latest/data-lake-storage-(gen-1)-mgmt-index.md b/docs-ref-services/latest/data-lake-storage-gen-1-mgmt-index.md
similarity index 100%
rename from docs-ref-services/latest/data-lake-storage-(gen-1)-mgmt-index.md
rename to docs-ref-services/latest/data-lake-storage-gen-1-mgmt-index.md
diff --git a/docs-ref-services/latest/data-lake-storage-(gen-1).md b/docs-ref-services/latest/data-lake-storage-gen-1.md
similarity index 100%
rename from docs-ref-services/latest/data-lake-storage-(gen-1).md
rename to docs-ref-services/latest/data-lake-storage-gen-1.md
diff --git a/docs-ref-services/latest/data-lake-storage-(gen-2)-client-index.md b/docs-ref-services/latest/data-lake-storage-gen-2-client-index.md
similarity index 100%
rename from docs-ref-services/latest/data-lake-storage-(gen-2)-client-index.md
rename to docs-ref-services/latest/data-lake-storage-gen-2-client-index.md
diff --git a/docs-ref-services/latest/data-lake-storage-(gen-2)-index.md b/docs-ref-services/latest/data-lake-storage-gen-2-index.md
similarity index 100%
rename from docs-ref-services/latest/data-lake-storage-(gen-2)-index.md
rename to docs-ref-services/latest/data-lake-storage-gen-2-index.md
diff --git a/docs-ref-services/latest/data-lake-storage-(gen-2).md b/docs-ref-services/latest/data-lake-storage-gen-2.md
similarity index 80%
rename from docs-ref-services/latest/data-lake-storage-(gen-2).md
rename to docs-ref-services/latest/data-lake-storage-gen-2.md
index ceefdb88d0d3..3db66ff410e1 100644
--- a/docs-ref-services/latest/data-lake-storage-(gen-2).md
+++ b/docs-ref-services/latest/data-lake-storage-gen-2.md
@@ -7,5 +7,5 @@ ms.service: datalakestorage(gen2)
 ---
 # Azure Data Lake Storage (Gen 2) SDK for Python - latest
 ## Packages - latest
-[!INCLUDE [packages](data-lake-storage-(gen-2)-index.md)]
-
+[!INCLUDE [packages](data-lake-storage-gen-2-index.md)]
+
diff --git a/docs-ref-services/latest/red-hat-openshift-(aro)-index.md b/docs-ref-services/latest/red-hat-openshift-aro-index.md
similarity index 100%
rename from docs-ref-services/latest/red-hat-openshift-(aro)-index.md
rename to docs-ref-services/latest/red-hat-openshift-aro-index.md
diff --git a/docs-ref-services/latest/red-hat-openshift-(aro)-mgmt-index.md b/docs-ref-services/latest/red-hat-openshift-aro-mgmt-index.md
similarity index 100%
rename from docs-ref-services/latest/red-hat-openshift-(aro)-mgmt-index.md
rename to docs-ref-services/latest/red-hat-openshift-aro-mgmt-index.md
diff --git a/docs-ref-services/latest/red-hat-openshift-(aro).md b/docs-ref-services/latest/red-hat-openshift-aro.md
similarity index 82%
rename from docs-ref-services/latest/red-hat-openshift-(aro).md
rename to docs-ref-services/latest/red-hat-openshift-aro.md
index 912ec720dfad..02d2fff1c5fb 100644
--- a/docs-ref-services/latest/red-hat-openshift-(aro).md
+++ b/docs-ref-services/latest/red-hat-openshift-aro.md
@@ -8,4 +8,4 @@ ms.service: redhatopenshift(aro)
 ---
 # Azure Red Hat OpenShift (ARO) SDK for Python - latest
 ## Packages - latest
-[!INCLUDE [packages](red-hat-openshift-(aro)-index.md)]
\ No newline at end of file
+[!INCLUDE [packages](red-hat-openshift-aro-index.md)]
diff --git a/docs-ref-services/legacy/data-lake-storage-(gen-1).md b/docs-ref-services/legacy/data-lake-storage-gen-1.md
similarity index 95%
rename from docs-ref-services/legacy/data-lake-storage-(gen-1).md
rename to docs-ref-services/legacy/data-lake-storage-gen-1.md
index ca8935f5c4a5..191fa0e39211 100644
--- a/docs-ref-services/legacy/data-lake-storage-(gen-1).md
+++ b/docs-ref-services/legacy/data-lake-storage-gen-1.md
@@ -9,20 +9,20 @@ ms.service: azure-data-lake-storage
 ms.technology: azure
 manager: douge
 ---
-# Azure Data Lake Store libraries for python
-
-## Install the libraries
-### Client
-
-```bash
-pip install azure-datalake-store
-```
-
-### Management
-
-```bash
-pip install azure-mgmt-datalake-store
-```
-> [!div class="nextstepaction"]
+# Azure Data Lake Store libraries for python
+
+## Install the libraries
+### Client
+
+```bash
+pip install azure-datalake-store
+```
+
+### Management
+
+```bash
+pip install azure-mgmt-datalake-store
+```
+> [!div class="nextstepaction"]
 > [Explore the Management APIs](/python/api/overview/azure/datalakestore/management)
-
+
diff --git a/docs-ref-services/preview/data-lake-storage-(gen-1).md b/docs-ref-services/preview/data-lake-storage-gen-1.md
similarity index 100%
rename from docs-ref-services/preview/data-lake-storage-(gen-1).md
rename to docs-ref-services/preview/data-lake-storage-gen-1.md
diff --git a/docs-ref-services/preview/data-lake-storage-(gen-2)-client-index.md b/docs-ref-services/preview/data-lake-storage-gen-2-client-index.md
similarity index 100%
rename from docs-ref-services/preview/data-lake-storage-(gen-2)-client-index.md
rename to docs-ref-services/preview/data-lake-storage-gen-2-client-index.md
diff --git a/docs-ref-services/preview/data-lake-storage-(gen-2)-index.md b/docs-ref-services/preview/data-lake-storage-gen-2-index.md
similarity index 100%
rename from docs-ref-services/preview/data-lake-storage-(gen-2)-index.md
rename to docs-ref-services/preview/data-lake-storage-gen-2-index.md
diff --git a/docs-ref-services/preview/data-lake-storage-(gen-2).md b/docs-ref-services/preview/data-lake-storage-gen-2.md
similarity index 81%
rename from docs-ref-services/preview/data-lake-storage-(gen-2).md
rename to docs-ref-services/preview/data-lake-storage-gen-2.md
index cc3ace4dab78..67b4f3eb9678 100644
--- a/docs-ref-services/preview/data-lake-storage-(gen-2).md
+++ b/docs-ref-services/preview/data-lake-storage-gen-2.md
@@ -7,5 +7,5 @@ ms.service: datalakestorage(gen2)
 ---
 # Azure Data Lake Storage (Gen 2) SDK for Python - preview
 ## Packages - preview
-[!INCLUDE [packages](data-lake-storage-(gen-2)-index.md)]
-
+[!INCLUDE [packages](data-lake-storage-gen-2-index.md)]
+
diff --git a/docs-ref-services/preview/red-hat-openshift-(aro)-index.md b/docs-ref-services/preview/red-hat-openshift-aro-index.md
similarity index 100%
rename from docs-ref-services/preview/red-hat-openshift-(aro)-index.md
rename to docs-ref-services/preview/red-hat-openshift-aro-index.md
diff --git a/docs-ref-services/preview/red-hat-openshift-(aro)-mgmt-index.md b/docs-ref-services/preview/red-hat-openshift-aro-mgmt-index.md
similarity index 100%
rename from docs-ref-services/preview/red-hat-openshift-(aro)-mgmt-index.md
rename to docs-ref-services/preview/red-hat-openshift-aro-mgmt-index.md
diff --git a/docs-ref-services/preview/red-hat-openshift-(aro).md b/docs-ref-services/preview/red-hat-openshift-aro.md
similarity index 81%
rename from docs-ref-services/preview/red-hat-openshift-(aro).md
rename to docs-ref-services/preview/red-hat-openshift-aro.md
index de91aa85d555..f7285476d7db 100644
--- a/docs-ref-services/preview/red-hat-openshift-(aro).md
+++ b/docs-ref-services/preview/red-hat-openshift-aro.md
@@ -7,5 +7,5 @@ ms.service: redhatopenshift(aro)
 ---
 # Azure Red Hat OpenShift (ARO) SDK for Python - preview
 ## Packages - preview
-[!INCLUDE [packages](red-hat-openshift-(aro)-index.md)]
-
+[!INCLUDE [packages](red-hat-openshift-aro-index.md)]
+