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

[cderv]

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

[mcanouil]

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

I think it is.
Creating "empty documents" with an include shortcode pointing to the shared document is the workaround here.

[AshleyHenry15]

With the Workbench docs, we have A LOT of aliases. Creating additional "empty documents" for a single piece of shared content, which may result in needing multiple aliases in the future, isn't ideal or easy to manage/scale for large website projects.

[mcanouil]

Indeed, with aliases, this workaround won't work very well or in a simple manner.

[cderv]

BTW we have the issue in our own website