Website Breadcrumbs is misleading when same document is used in multiple sections in sidebar

Reported by @ashleyhenry15 on a bigger webs
Demo website to reproduce: https://github.com/cderv/debug-website-sidebar-breadcrumbs/tree/main

When the same file is used in two places in sidebar section like

  sidebar:
  - id: admin-guide
    collapse-level: 1
    contents:
      - text: "Introduction"
        href: admin/index.qmd
      - text: "---"
      - section: "SmartWidget Pro"
        contents:
          - text: "Overview"
            href: admin/smartwidget/overview.qmd
          - admin/integrations/api_guide.qmd
      - section: "CRM Connect"
        contents:
          - text: "Overview"
            href: admin/crm/overview.qmd
          - admin/integrations/api_guide.qmd

The link of the second will send to the first page. This is a about breadscrumbs et page content

This is definitely misleading to users, but I don't know if we could share the same page and have the breadcrumbs and highlighted sidebar part updated correctly.

I wonder if this should be two documents instead, for different HTML in output, and each would use same include 🤔
This could be a workaroudn

Start with the linked demo website to reproduce the breadcrumb and sidebar behavior when admin/integrations/api_guide.qmd appears in both sections. Done means selecting the second API guide opens the intended context and updates the breadcrumbs and highlighted sidebar entry correctly.