Merge pull request #4930 from bojunehsu/paulhsu/CU-toc

denrea · web-flow · commit f753b0dad870 · 2025-05-21T10:12:16.000-07:00
Reorganize TOC to have Analyzers/Classifiers/Face/Foundry at top level
diff --git a/articles/ai-services/content-understanding/index.yml b/articles/ai-services/content-understanding/index.yml
@@ -1,73 +1,112 @@
-### YamlMime:Landing
+### YamlMime:Hub
 
 title: Azure AI Content Understanding documentation
-summary: Content Understanding is a solution that analyzes and comprehends various media content—such as audio, video, text, and images—transforming it into structured, organized, and searchable data.
+summary: Content Understanding is a solution that analyzes and comprehends various media content—such as documents, images, audio, and video—transforming it into structured, organized, and searchable data.
 metadata:
   title: Azure AI Content Understanding documentation
-  description: Content Understanding is a solution that analyzes and comprehends various media content—such as audio, video, text, and images—transforming it into structured, organized, and searchable data.
+  description: Content Understanding is a solution that analyzes and comprehends various media content—such as documents, images, audio, and video—transforming it into structured, organized, and searchable data.
   ms.service: azure-ai-content-understanding
   ms.topic: landing-page
   author: laujan
   ms.author: lajanuar
   ms.date: 05/19/2025
 
-landingContent:
+highlightedContent:
+# itemType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | whats-new
+  items:
+    - title: What is Content Understanding?
+      itemType: overview
+      url: overview.md
+    - title: "What's new?"
+      itemType: whats-new
+      url: whats-new.md
+    - title: Try REST API
+      itemType: quickstart
+      url: quickstart/use-rest-api.md
+    - title: Try AI Foundry
+      itemType: quickstart
+      url: quickstart/use-ai-foundry.md
 
-  - title: About Azure AI Content Understanding
-    linkLists:
-      - linkListType: overview
-        links:
-          - text: What is Azure AI Content Understanding?
-            url: overview.md
-          - text: Azure AI Content Understanding REST API
-            url: /rest/api/contentunderstanding/operation-groups?view=rest-contentunderstanding-2024-12-01-preview&preserve-view=true
-          - text: FAQ
-            url: faq.yml
-
-  - title: Capabilities
-    linkLists:
-      - linkListType: concept
-        links:
-        - text: Audio
+conceptualContent:
+  items:
+    - title: AI Foundry
+      links:
+        - itemType: quickstart
+          text: Quickstart
+          url: quickstart/use-ai-foundry.md
+        - itemType: concept
+          text: Analyzer templates
+          url: concepts/analyzer-templates.md
+    - title: Analyzers
+      links:
+        - itemType: quickstart
+          text: Quickstart
+          url: quickstart/use-rest-api.md
+        - itemType: concept
+          text: "Modes: standard and pro"
+          url: concepts/standard-pro-modes.md
+        - itemType: concept
+          text: Prebuilt analyzers
+          url: concepts/prebuilt-analyzers.md
+        - itemType: how-to-guide
+          text: Create a custom analyzer
+          url: tutorial/create-custom-analyzer.md
+    - title: Classifiers
+      links:
+        - itemType: overview
+          text: Overview
+          url: concepts/classifier.md
+    - title: Face and person directories
+      links:
+        - itemType: overview
+          text: Overview
+          url: face/overview.md
+        - itemType: how-to-guide
+          text: Build a person directory
+          url: tutorial/build-person-directory.md
+    - title: Modalities
+      links:
+        - itemType: concept
+          text: Document
+          url: document/overview.md
+        - itemType: concept
+          text: Image
+          url: image/overview.md
+        - itemType: concept
+          text: Audio
           url: audio/overview.md
-        - text: Video
+        - itemType: concept
+          text: Video
           url: video/overview.md
-        - text: Image
-          url: image/overview.md
-        - text: Document
-          url: document/overview.md
-
-  - title: Get started
-    linkLists:
-      - linkListType: quickstart
-        links:
-        - text: Try Content Understanding REST API
-          url: quickstart/use-rest-api.md
-        - text: Try Azure AI Foundry portal
-          url: quickstart/use-ai-foundry.md
-
-  - title: How-to guides
-    linkLists:
-      - linkListType: how-to-guide
-        links:
-        - text: Create an AI Foundry resource
-          url: how-to/create-multi-service-resource.md
-
-  - title: "What's new?"
-    linkLists:
-      - linkListType: whats-new
-        links:
-        - text: "What's new in Azure AI Content Understanding?"
-          url: whats-new.md
-
-  - title: Reference
-    linkLists:
-        - linkListType: reference
-          links:
-          - text: Service limits
-            url: service-limits.md
-          - text: Language and region support
-            url: language-region-support.md
-
+    - title: Tutorials
+      links:
+        - itemType: how-to-guide
+          text: Create a custom analyzer
+          url: tutorial/create-custom-analyzer.md
+        - itemType: how-to-guide
+          text: Build a person directory
+          url: tutorial/build-person-directory.md
+    - title: Resources
+      links:
+        - itemType: reference
+          text: Service limits
+          url: service-limits.md
+        - itemType: reference
+          text: Language and region support
+          url: language-region-support.md
+        - itemType: tutorial
+          text: Azure AI Content Understanding Samples (Python)
+          url: https://github.com/Azure-Samples/azure-ai-content-understanding-python
+    - title: Reference
+      links:
+        - itemType: reference
+          text: FAQ
+          url: faq.yml
+        - itemType: reference
+          text: Glossary
+          url: glossary.md
+        - itemType: reference
+          text: REST API
+          url: /rest/api/contentunderstanding/operation-groups
 
 
diff --git a/articles/ai-services/content-understanding/toc.yml b/articles/ai-services/content-understanding/toc.yml
@@ -1,98 +1,106 @@
 items:
-- name: Azure AI Content Understanding Documentation
-  href: index.yml
-- name: Overview
-  expanded: true
-  items:
-  - name: What is Azure AI Content Understanding?
-    displayName: document, text, images, video, audio, multimodal, visual, structured, content, field, extraction, content filtering, filter
-    href: overview.md
-  - name: Create an Azure AI Foundry resource
-    displayName: extract, text, images, OCR, optical character recognition
-    href: how-to/create-multi-service-resource.md
-  - name: What's new
-    displayName: changelog, release, updates, previews
-    href: whats-new.md
-  - name: Service quotas and limits
-    displayName: quota, tiers, throttle, max, adjustments, requests, support, ocr
-    href: service-limits.md
-  - name: Language and region support
-    href: language-region-support.md
-  - name: Pricing
-    href: https://azure.microsoft.com/pricing/details/content-understanding/
-  - name: FAQ
-    displayName: FAQ, definition, updates, previews
-    href: faq.yml
-  - name: Glossary
-    displayName: glossary, definition, updates, previews
-    href: glossary.md
-- name: Quickstarts
-  items:
-  - name: Content Understanding REST API
-    displayName: quickstart, extract, text, images, OCR, optical character recognition, content filtering, filter
-    href: quickstart/use-rest-api.md
-  - name: Content Understanding Azure AI Foundry portal
-    displayName: quickstart, extract, text, images, OCR, optical character recognition
-    href: quickstart/use-ai-foundry.md
-- name: Analyzers and features
-  items:
-  - name: Analyzer templates
-    displayName: analyzer, templates, document, text, images, video, audio, multimodal, visual, structured, content, field, extraction
-    href: concepts/analyzer-templates.md
-  - name: Document
+  - name: Azure AI Content Understanding documentation
+    href: index.yml
+  - name: Overview
+    expanded: true
+    items:
+      - name: What is Azure AI Content Understanding?
+        displayName: document, text, images, video, audio, multimodal, visual, structured, content, field, extraction, content filtering, filter
+        href: overview.md
+      - name: What's new
+        displayName: changelog, release, updates, previews
+        href: whats-new.md
+      - name: Create an Azure AI Foundry resource
+        displayName: extract, text, images, OCR, optical character recognition
+        href: how-to/create-multi-service-resource.md
+      - name: Service quotas and limits
+        displayName: quota, tiers, throttle, max, adjustments, requests, support, ocr
+        href: service-limits.md
+      - name: Language and region support
+        href: language-region-support.md
+      - name: Pricing
+        href: https://azure.microsoft.com/pricing/details/content-understanding/
+      - name: FAQ
+        displayName: FAQ, definition, updates, previews
+        href: faq.yml
+      - name: Glossary
+        displayName: glossary, definition, updates, previews
+        href: glossary.md
+  - name: "AI Foundry: Content Understanding"
+    items:
+      - name: Quickstart
+        displayName: quickstart, extract, text, images, OCR, optical character recognition
+        href: quickstart/use-ai-foundry.md
+      - name: Analyzer templates
+        displayName: analyzer, templates, document, text, images, video, audio, multimodal, visual, structured, content, field, extraction
+        href: concepts/analyzer-templates.md
+  - name: Analyzers
+    items:
+      - name: "Quickstart"
+        displayName: quickstart, extract, text, images, OCR, optical character recognition, content filtering, filter
+        href: quickstart/use-rest-api.md
+      - name: Modalities
+        items:
+          - name: Document
+            items:
+              - name: Overview
+                displayName: document, text, images, video, audio, visual, structured, content, field, extraction
+                href: document/overview.md
+              - name: Elements 🆕
+                displayName: document, text, images, video, audio, visual, structured, content, field, extraction
+                href: document/elements.md
+              - name: xMarkdown 🆕
+                displayName: document, text, images, video, audio, visual, structured, content, field, extraction
+                href: document/markdown.md
+          - name: Image
+            displayName: image, OCR, optical character recognition, text, extraction, analysis, detection, recognition, model
+            href: image/overview.md
+          - name: Audio
+            displayName: speech, audio, voice, recognition, synthesis, speaker, identification, verification, diarization, transcription, translation, language, understanding, sentiment, analysis, emotion, detection, pronunciation, model
+            href: audio/overview.md
+          - name: Video
+            href: video/overview.md
+            displayName: video, audio, voice, recognition, synthesis, speaker, identification, verification, diarization, transcription, translation, language, understanding, sentiment, analysis, emotion, detection, pronunciation, model
+      - name: Concepts
+        items:
+          - name: Prebuilt analyzers 🆕
+            displayName: analyzer, templates, document, text, images, video, audio, multimodal, visual, structured, content, field, extraction
+            href: concepts/prebuilt-analyzers.md
+          - name: "Modes: standard and pro 🆕"
+            displayName: standard, pro, modes, analyzers, optimization, fields
+            href: concepts/standard-pro-modes.md
+          - name: Best practices
+            displayName: best practices, analyzers, optimization, fields
+            href: concepts/best-practices.md
+      - name: Tutorials
+        items:
+          - name: Create a custom analyzer 🆕
+            displayName: custom, analyzer, document, text, images, video, audio, multimodal, visual, structured, content, field, extraction
+            href: tutorial/create-custom-analyzer.md
+          - name: Build a retrieval-augmented solution
+            displayName: RAG, retrieval, augmented, generation, knowledge, base, search, index, vector
+            href: tutorial/build-rag-solution.md
+  - name: Classifiers 🆕
     items:
       - name: Overview
-        displayName: document, text, images, video, audio, visual, structured, content, field, extraction
-        href: document/overview.md
-      - name: Document elements
-        displayName: document, text, images, video, audio, visual, structured, content, field, extraction
-        href: document/elements.md
-      - name: Markdown elements
-        displayName: document, text, images, video, audio, visual, structured, content, field, extraction
-        href: document/markdown.md
-  - name: Image
-    displayName: image, OCR, optical character recognition, text, extraction, analysis, detection, recognition, model
-    href: image/overview.md
-  - name: Audio
-    displayName: speech, audio, voice, recognition, synthesis, speaker, identification, verification, diarization, transcription, translation, language, understanding, sentiment, analysis, emotion, detection, pronunciation, model
-    href: audio/overview.md
-  - name: Video
-    href: video/overview.md
-    displayName: video, audio, voice, recognition, synthesis, speaker, identification, verification, diarization, transcription, translation, language, understanding, sentiment, analysis, emotion, detection, pronunciation, model
-  - name: Face
-    displayName: face, recognition, detection, analysis, identification, verification
-    href: face/overview.md
-- name: Concepts
-  items:
-    - name: Best practices
-      displayName: best practices, analyzers, optimization, fields
-      href: concepts/best-practices.md
-    - name: "🆕 Modes: standard and pro"
-      displayName: standard, pro, modes, analyzers, optimization, fields
-      href: concepts/standard-pro-modes.md
-    - name: 🆕 Classifier
-      displayName: classifier, text, images, video, audio, multimodal, visual, structured, content, field, extraction
-      href: concepts/classifier.md
-    - name: 🆕 Prebuilt analyzers
-      displayName: analyzer, templates, document, text, images, video, audio, multimodal, visual, structured, content, field, extraction
-      href: concepts/prebuilt-analyzers.md
-- name: Tutorials
-  items:
-    - name: Create a custom analyzer
-      displayName: custom, analyzer, document, text, images, video, audio, multimodal, visual, structured, content, field, extraction
-      href: tutorial/create-custom-analyzer.md 
-    - name: Build a person directory
-      displayName: person, directory, search, index, vector
-      href: tutorial/build-person-directory.md
-- name: Responsible AI
-  items:
-    - name: Transparency note
-      href: /legal/cognitive-services/content-understanding/transparency-note?toc=/azure/ai-services/content-understanding/toc.json&bc=/azure/ai-services/content-understanding/breadcrumb/toc.json
-    - name: Data, privacy, and security
-      href: /legal/cognitive-services/content-understanding/data-privacy?toc=/azure/ai-services/content-understanding/toc.json&bc=/azure/ai-services/content-understanding/breadcrumb/toc.json
-- name: Reference
-  items:
-  - name: REST API
-    displayName: quota, tiers, throttle, max, adjustments, requests, support, ocr
-    href: /rest/api/contentunderstanding/operation-groups?view=rest-contentunderstanding-2024-12-01-preview&preserve-view=true
-
+        displayName: classifier, text, images, video, audio, multimodal, visual, structured, content, field, extraction
+        href: concepts/classifier.md
+  - name: Face 🆕
+    items:
+      - name: Overview
+        displayName: face, recognition, detection, analysis, identification, verification
+        href: face/overview.md
+      - name: "Tutorial: Build a person directory"
+        displayName: person, directory, search, index, vector
+        href: tutorial/build-person-directory.md
+  - name: Responsible AI
+    items:
+      - name: Transparency note
+        href: /legal/cognitive-services/content-understanding/transparency-note?toc=/azure/ai-services/content-understanding/toc.json&bc=/azure/ai-services/content-understanding/breadcrumb/toc.json
+      - name: Data, privacy, and security
+        href: /legal/cognitive-services/content-understanding/data-privacy?toc=/azure/ai-services/content-understanding/toc.json&bc=/azure/ai-services/content-understanding/breadcrumb/toc.json
+  - name: Reference
+    items:
+      - name: REST API
+        displayName: quota, tiers, throttle, max, adjustments, requests, support, ocr
+        href: /rest/api/contentunderstanding/operation-groups
