Skip to content

docs tool issues for JSON produces duplicate id #1076

Open

Description

@jkowalleck

the JSON docs tool produces duplicate ids.

this does not affect the click-ability of an element in the rendered docs,
but it affects the linkablility.

for example, when clicking on $.components[].mimetype it changes the browser's location bar to "https://cyclonedx.org/docs/1.7/json/#metadata_tools_oneOf_i0_components_items_mime-type"

this is due to these duplicate ids, see occurrence of "metadata_tools_oneOf_i0_components_items_mime-typ" - it appears 8 times.

$ wget -O - https://cyclonedx.org/docs/1.7/json/ \
  | grep -ow 'id="metadata_tools_oneOf_i0_components_items_mime-type"' \
  | wc -l
2

Activity

  1. self-assigned this
    on Sep 2, 2026
  2. jkowalleck commented on Sep 2, 2026

    @jkowalleck
    MemberAuthor

    issue seams to be caused by 526a2db

    proposed strategy:

    1. immediately rollback this change
    2. EITHER: have the improvements of 526a2db fixed
      and rollout those fixed improvements
    3. OR: use the new docs tool
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions