index.yml

### YamlMime:Hub
# hub page for Enterprise docset & Edge Dev docset; https://learn.microsoft.com/microsoft-edge/
title: Microsoft Edge documentation
summary: Explore documentation, references, and code samples to help you deploy, manage, and build with Microsoft Edge.
brand: m365
metadata:
  title: Microsoft Edge documentation
  description: Microsoft Edge information for developers, IT admins, and browser users; including DevTools, Edge Add-ons (such as extensions), PWAs, WebDriver, and more.
  ms.topic: hub-page
  author: MSEdgeTeam
  ms.author: msedgedevrel
  ms.date: 12/10/2024
  ms.localizationpriority: high
  ms.service: microsoft-edge

# How to create or update a hub page
# https://review.learn.microsoft.com/en-us/help/platform/navigation-how-create-hub-page?branch=main

# =============================================================================
# topmost section of hub page; 2 rows of 4 cards
# Maximum of 8 items
highlightedContent:
# itemType: architecture | concept | deploy | download | get-started | how-to-guide | overview | quickstart | reference | sample | training | tutorial | video | whats-new
  items:

# =============================================================================
# Row 1 (4 cards)
# -----------------------------------------------------------------------------
# Card r1c1
    - title: Microsoft Edge for Business
      url: https://www.microsoft.com/edge/business/download
      itemType: download

# -----------------------------------------------------------------------------
# Card r1c2
    - title: Microsoft Edge Insider Channels
      url: https://www.microsoft.com/edge/download/insider
      itemType: download

# -----------------------------------------------------------------------------
# Card r1c3
    - title: WebView2
      url: https://developer.microsoft.com/microsoft-edge/webview2/#download
      itemType: download

# -----------------------------------------------------------------------------
# Card r1c4
    - title: Microsoft Edge Roadmap
      url: https://www.microsoft.com/microsoft-365/roadmap?filters=Microsoft%20Edge   # https://www.microsoft.com/edge/update/latest (shows 1 at a time)
      itemType: reference

# =============================================================================
# Row 2 (4 cards)
# -----------------------------------------------------------------------------
# Card r2c1
    - title: Microsoft Edge for Business  # scrolls down to hub page section
      url: /microsoft-edge/index#microsoft-edge-for-business  # https://learn.microsoft.com/microsoft-edge/#microsoft-edge-for-business
      itemType: training

# -----------------------------------------------------------------------------
# Card r2c2
    - title: Microsoft Edge for Developers  # scrolls down to hub page section
      url: /microsoft-edge/index#microsoft-edge-for-developers  # https://learn.microsoft.com/microsoft-edge/#microsoft-edge-for-developers
      itemType: training

# -----------------------------------------------------------------------------
# Card r2c3
    - title: Help and Support  # scrolls down to hub page section
      url: /microsoft-edge/index#help-and-support  # https://learn.microsoft.com/microsoft-edge/#help-and-support
      itemType: training

# -----------------------------------------------------------------------------
# Card r2c4
    - title: Microsoft Edge help & learning  # end-user info at SMC (member of above)
      url: https://support.microsoft.com/microsoft-edge
      itemType: training

# =============================================================================
# "Microsoft Edge for Enterprise" section of hub page: 2 rows of up to 4 cards
conceptualContent:
# itemType: architecture | concept | deploy | download | get-started | how-to-guide | overview | quickstart | reference | sample | training | tutorial | video | whats-new
# Supports up to 3 subsections
  sections:
    - title: Microsoft Edge for Business # < 60 chars (optional)
      # summary:  # < 160 chars (optional)
      items:

# =============================================================================
# Row 1 (4 cards)
# -----------------------------------------------------------------------------
# Card r1c1
        - title: Learn about Microsoft Edge for Business
          links:
            - text: Overview of the Microsoft Edge channels
              url: /deployedge/microsoft-edge-channels  # https://learn.microsoft.com/deployedge/microsoft-edge-channels
              itemType: overview

            - text: Use enterprise features  # dest: Microsoft Edge for Business
              url: /deployedge/microsoft-edge-for-business  # https://learn.microsoft.com/deployedge/microsoft-edge-for-business
              itemType: reference

# -----------------------------------------------------------------------------
# Card r1c2
        - title: Deploy and update Microsoft Edge for Business
          links:
            - text: Deploy to Windows
              url: /configmgr/apps/deploy-use/deploy-edge  # https://learn.microsoft.com/configmgr/apps/deploy-use/deploy-edge
              itemType: deploy

            - text: Deploy to macOS
              url: /mem/intune/apps/apps-edge-macos  # https://learn.microsoft.com/mem/intune/apps/apps-edge-macos
              itemType: deploy

            - text: Deploy to BYOD devices
              url: /deployedge/microsoft-edge-for-business-config-recommendations#protecting-users-and-devices  # https://learn.microsoft.com/deployedge/microsoft-edge-for-business-config-recommendations#protecting-users-and-devices
              itemType: deploy

            - text: Deploy to mobile
              url: /intune/intune-service/fundamentals/guided-scenarios-edge  # https://learn.microsoft.com/intune/intune-service/fundamentals/guided-scenarios-edge
              itemType: deploy

# -----------------------------------------------------------------------------
# Card r1c3
        - title: Configure Microsoft Edge for Business
          links:
            - text: Configure Microsoft Edge for Business on Windows and macOS
              url: /deployedge/configure-microsoft-edge  # https://learn.microsoft.com/deployedge/configure-microsoft-edge
              itemType: how-to-guide

            - text: Set Microsoft Edge for Business as the default browser
              url: /deployedge/edge-default-browser  # https://learn.microsoft.com/deployedge/edge-default-browser
              itemType: how-to-guide

            - text: Manage Microsoft Edge for Business on iOS and Android with Intune
              url: /mem/intune/apps/manage-microsoft-edge  # https://learn.microsoft.com/mem/intune/apps/manage-microsoft-edge
              itemType: how-to-guide

# -----------------------------------------------------------------------------
# Card r1c4
        - title: Manage security and privacy
          links:
            - text: Security  # dest: Microsoft Edge security for your business
              url: /deployedge/ms-edge-security-for-business  # https://learn.microsoft.com/deployedge/ms-edge-security-for-business
              itemType: concept

            - text: Privacy  # dest: Configure Microsoft Edge policies to support enterprise privacy
              url: /deployedge/microsoft-edge-enterprise-privacy-settings  # https://learn.microsoft.com/deployedge/microsoft-edge-enterprise-privacy-settings
              itemType: how-to-guide

# =============================================================================
# Row 2 (3 cards, max 4)
# -----------------------------------------------------------------------------
# Card r2c1
        - title: Policy reference
          links:
            - text: Browser policy reference  # dest: Microsoft Edge - Policies
              url: /deployedge/microsoft-edge-policies  # https://learn.microsoft.com/deployedge/microsoft-edge-policies
              itemType: reference

            - text: Update policy reference  # dest: Microsoft Edge - Update policies
              url: /deployedge/microsoft-edge-update-policies  # https://learn.microsoft.com/deployedge/microsoft-edge-update-policies
              itemType: reference

# -----------------------------------------------------------------------------
# Card r2c2
        - title: Engage with enterprise community
          links:
            - text: Enterprise tech community (Insider Focused)
              url: https://techcommunity.microsoft.com/t5/Enterprise/bd-p/EdgeInsiderEnterprise
              itemType: reference  # forum-posts filter

# -----------------------------------------------------------------------------
# Card r2c3
        - title: Extensions for enterprise  # add-ons include extensions, themes, web apps
          links:
            - text: Manage extensions for Microsoft Edge for Business
              url: /deployedge/microsoft-edge-manage-extensions  # https://learn.microsoft.com/deployedge/microsoft-edge-manage-extensions
              itemType: overview

            - text: Defining match patterns for an extension to access file URLs
              url: ./extensions/developer-guide/match-patterns.md  # https://learn.microsoft.com/microsoft-edge/extensions/developer-guide/match-patterns
              itemType: reference

            - text: Extension hosting
              url: ./extensions/publish/hosting-and-updating.md  # https://learn.microsoft.com/microsoft-edge/extensions/publish/hosting-and-updating
              itemType: reference

# -----------------------------------------------------------------------------
# Card r2c4


# =============================================================================
# "Microsoft Edge for Developers" section of hub page - 2 rows of 4 cards
    - title: Microsoft Edge for Developers # < 60 chars (optional)
    # summary:  # < 160 chars (optional)
      items:

# =============================================================================
# Row 1 (4 cards)
# -----------------------------------------------------------------------------
# Card for toc bucket 1 (Release notes) & 2 (Experimental web platform features) - r1c1
        - title: Web platform updates
          links:
            - text: Release notes for Microsoft Edge web platform
              url: ./web-platform/release-notes/index.md
              itemType: whats-new

            - text: Site compatibility-impacting changes
              url: ./web-platform/site-impacting-changes.md
              itemType: whats-new

            - text: Use origin trials in Microsoft Edge
              url: ./origin-trials/index.md
              itemType: whats-new

            - text: Prompt a built-in language model with the Prompt API
              url: ./web-platform/prompt-api.md
              itemType: whats-new

            - text: Summarize, write, and rewrite text with the Writing Assistance APIs
              url: ./web-platform/writing-assistance-apis.md
              itemType: whats-new

# -----------------------------------------------------------------------------
# Card for toc bucket 3 - r1c2
        - title: Microsoft Edge DevTools
          links:
            - text: Microsoft Edge Developer documentation  # docset landing page (link is in hub page only)
              url: ./developer/index.yml
              itemType: overview

            - text: Microsoft Edge DevTools documentation  # devtools landing page
              url: ./devtools/landing/index.yml
              itemType: overview

            - text: Overview of DevTools
              url: ./devtools/overview.md
              itemType: overview

            - text: What's New in Microsoft Edge DevTools
              url: ./devtools/whats-new/whats-new.md
              itemType: whats-new

            - text: Command Menu
              url: ./devtools/command-menu/index.md
              itemType: how-to-guide

            - text: View and change CSS
              url: ./devtools/css/index.md
              itemType: how-to-guide

            - text: Keyboard shortcuts
              url: ./devtools/shortcuts/index.md
              itemType: reference

# -----------------------------------------------------------------------------
# Card for toc bucket 4 - r1c3
        - title: Microsoft Edge extensions
          links:
            - text: Microsoft Edge extensions documentation  # extensions landing page
              url: ./extensions/landing/index.yml
              itemType: overview

            - text: Overview of Microsoft Edge extensions
              url: ./extensions/index.md
              itemType: overview

            - text: Extension concepts and architecture
              url: ./extensions/getting-started/index.md
              itemType: overview

            - text: "Sample: Picture viewer pop-up webpage"
              url: ./extensions/samples/picture-viewer-popup-webpage.md
              itemType: sample

            - text: "Sample: Picture inserter using content script"
              url: ./extensions/samples/picture-inserter-content-script.md
              itemType: sample

            - text: Port a Chrome extension to Microsoft Edge
              url: ./extensions/developer-guide/port-chrome-extension.md
              itemType: how-to-guide

            - text: Alternative ways to distribute an extension
              url: ./extensions/developer-guide/alternate-distribution-options.md
              itemType: how-to-guide

            - text: Step-wise publishing process
              url: ./extensions/publish/publish-extension.md
              itemType: how-to-guide

            - text: Register as a Microsoft Edge extension developer
              url: ./extensions/publish/create-dev-account.md
              itemType: how-to-guide

# -----------------------------------------------------------------------------
# Card for toc bucket 5 - r1c4
        - title: Progressive Web Apps (PWAs)
          links:
            - text: Progressive Web Apps (PWAs) documentation  # pwa landing page
              url: ./progressive-web-apps/landing/index.yml
              itemType: overview

            - text: Overview of Progressive Web Apps
              url: ./progressive-web-apps/index.md
              itemType: overview

            - text: What's New in PWAs
              url: ./progressive-web-apps/whats-new/pwa.md
              itemType: whats-new

            - text: Get started developing a PWA
              url: ./progressive-web-apps/how-to/index.md
              itemType: get-started

            - text: Using Service Workers
              url: https://developer.mozilla.org/docs/Web/API/Service_Worker_API/Using_Service_Workers
              itemType: get-started

            - text: The web app manifest  # in _Making PWAs installable_
              url: https://developer.mozilla.org/docs/Web/Progressive_web_apps/Guides/Making_PWAs_installable#the_web_app_manifest
              itemType: get-started

            - text: Publish a PWA to the Microsoft Store
              url: ./progressive-web-apps/how-to/microsoft-store.md
              itemType: how-to-guide

            - text: Store data on the device
              url: ./progressive-web-apps/how-to/offline.md
              itemType: how-to-guide

# =============================================================================
# Row 2 (4 cards)
# -----------------------------------------------------------------------------
# Card for toc bucket 6 - r2c1
        - title: WebView2
          links:
            - text: WebView2 documentation  # wv2 landing page
              url: ./webview2/landing/index.yml
              itemType: overview

            - text: Introduction to Microsoft Edge WebView2
              url: ./webview2/index.md
              itemType: overview

            - text: Differences between Microsoft Edge and WebView2
              url: ./webview2/concepts/browser-features.md
              itemType: concept

            - text: Development best practices
              url: ./webview2/concepts/developer-guide.md
              itemType: concept

            - text: Get started with WebView2
              url: ./webview2/get-started/get-started.md
              itemType: get-started

            - text: WebView2 sample apps
              url: ./webview2/samples/index.md
              itemType: download

            - text: Release Notes for the WebView2 SDK
              url: ./webview2/release-notes/index.md
              itemType: whats-new

            - text: WebView2 API Reference
              url: ./webview2/webview2-api-reference.md
              itemType: reference

# -----------------------------------------------------------------------------
# Card for toc bucket 7 - r2c2
        - title: Test and automation
          links:
            - text: Test and automation in Microsoft Edge
              url: ./test-and-automation/test-and-automation.md
              itemType: overview

            - text: DevTools Protocol
              url: ./test-and-automation/devtools-protocol.md  # jump page
              itemType: how-to-guide

            - text: Use Playwright to automate and test in Microsoft Edge
              url: ./playwright/index.md
              itemType: overview

            - text: Puppeteer overview
              url: ./puppeteer/index.md
              itemType: how-to-guide

            - text: Use WebDriver to automate Microsoft Edge
              url: ./webdriver/index.md
              itemType: how-to-guide

            - text: webhint extension for Visual Studio Code
              url: ./visual-studio-code/webhint.md
              itemType: how-to-guide

# -----------------------------------------------------------------------------
# Card for toc bucket 8 - r2c3
        - title: Edge-specific web development tips
          links:
#           - text: Edge-specific web development tips  # jump page for overview of bucket, omit bc 10 max
#             url: ./web-platform/web-platform.md
#             itemType: overview

            - text: Move users to Microsoft Edge from Internet Explorer
              url: ./web-platform/ie-to-microsoft-edge-redirection.md
              itemType: how-to-guide

            - text: Tracking prevention in Microsoft Edge
              url: ./web-platform/tracking-prevention.md
              itemType: how-to-guide

            - text: Detect Microsoft Edge from your website
              url: ./web-platform/user-agent-guidance.md
              itemType: how-to-guide

            - text: Develop experiences for the sidebar in Microsoft Edge
              url: ./web-platform/sidebar.md
              itemType: how-to-guide

            - text: Detect Windows 11 and CPU architecture using User-Agent Client Hints
              url: ./web-platform/how-to-detect-win11.md
              itemType: how-to-guide

            - text: Customize the password reveal button
              url: ./web-platform/password-reveal.md
              itemType: how-to-guide

            - text: Display regional versions of your site, based on OS settings
              url: ./web-platform/os-regional-settings.md
              itemType: how-to-guide

            - text: View a JSON file or server response with formatting
              url: ./web-platform/json-viewer.md
              itemType: how-to-guide

# -----------------------------------------------------------------------------
# Card for toc bucket 9 - r2c4
        - title: Microsoft Edge IDE integration
          links:
            - text: Microsoft Edge IDE integration
              url: ./visual-studio-code/ide-integration.md
              itemType: overview

            - text: Microsoft Edge DevTools extension for Visual Studio Code
              url: ./visual-studio-code/microsoft-edge-devtools-extension.md  # goes directly to main page, in DevTools
              itemType: how-to-guide

            - text: Opening source files in Visual Studio Code
              url: ./devtools/sources/opening-sources-in-vscode.md
              itemType: how-to-guide

            - text: Debug Microsoft Edge in Visual Studio Code
              url: ./visual-studio-code/debugger-for-edge.md
              itemType: overview

            - text: Visual Studio for web development
              url: ./visual-studio-code/index.md
              itemType: how-to-guide

# =============================================================================
# Row 3 (4 cards max) - hid b/c adding cards changes layout to 3 per row instead of 4 per row
# -----------------------------------------------------------------------------
# Card for toc bucket 10 - r_c_
# Card r2c4
#       - title: Accessibility in Microsoft Edge
#         links:
#           - text: Accessibility-testing features
#             url: ./devtools/accessibility/reference.md
#             itemType: overview

#           - text: Accessibility overview
#             url: ./accessibility/index.md
#             itemType: overview

#           - text: Accessibility testing
#             url: ./accessibility/test.md
#             itemType: how-to-guide

# -----------------------------------------------------------------------------
# Card for toc bucket 11 - r_c_
# Card r3c1
#         - title: DualEngine
#           links:
#             - text: Introduction to the Microsoft DualEngine API
#               url: ./dualengine/intro.md
#               itemType: overview
 
#             - text: Getting started with the DualEngine API
#               url: ./dualengine/get-started.md
#               itemType: get-started
 
#             - text: Creating a DualEngine adapter plugin DLL
#               url: ./dualengine/concepts/adapter-dll.md
#               itemType: how-to-guide
 
#             - text: Launching Internet Explorer
#               url: ./dualengine/concepts/launching-internet-explorer.md
#               itemType: how-to-guide

#             - text: DualEngine Win32 C++ Reference
#               url: ./dualengine/reference/index.md
#               itemType: reference

# =============================================================================
# "Help and Support" section of hub page - 1 row of 3 cards
# Cards with summary style
additionalContent:
  # Supports up to 4 sections
  sections:
    - title: Help and Support # < 60 chars (optional)
      # summary: sectionsummary # < 160 chars (optional)
      items:
# -----------------------------------------------------------------------------
# Card
        - title: Community Support on Microsoft Q&A
          summary: Get advice and answers from community experts.
          url: /answers/topics/ms-edge.html  # https://learn.microsoft.com/answers/tags/781/microsoft-edge
# -----------------------------------------------------------------------------
# Card
        - title: Microsoft Support for business
          summary: If your business needs immediate technical support for Microsoft Edge, 1-on-1 support is available using a variety of plans.
          url: https://support.microsoft.com/supportforbusiness/productselection?sapId=a77ee9b7-b6b6-aa08-d7b9-887ebe228207
# -----------------------------------------------------------------------------
# Card
        - title: Microsoft Edge help & learning
          summary: Support for end users about how to use Microsoft Edge features.
          url: https://support.microsoft.com/microsoft-edge

# =============================================================================
# "Reference and Legacy Docs" section of hub page - 1 row of 2 cards
    - title: Reference and Legacy Docs # < 60 chars (optional)
      # summary: sectionsummary # < 160 chars (optional)
      items:
# -----------------------------------------------------------------------------
# Card
        - title: Reference
          links:
            - text: Detecting Microsoft Edge from your website
              url: ./web-platform/user-agent-guidance.md

            - text: Visual Studio Code
              url: ./visual-studio-code/index.md

            - text: User data and privacy in Microsoft Edge
              url: /legal/microsoft-edge/privacy  # https://learn.microsoft.com/legal/microsoft-edge/privacy
# -----------------------------------------------------------------------------
# Card
        - title: Microsoft Edge Legacy documentation
          links:
            - text: Microsoft Edge Legacy documentation
              url: /archive/microsoft-edge/legacy/developer/  # https://learn.microsoft.com/archive/microsoft-edge/legacy/developer/