docs tool issues for JSON produces duplicate id

Open

#1,076 opened on Sep 2, 2026 1 comment 0 reactions 1 assignee View on GitHub

@jkowalleck is already working on this.

Since Sep 2, 2026.

Assessment

This issue has not been assessed yet.

defect documentation format: JSON

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

Read the whole issue, then the project's contributing guide.
Comment on the issue to say you are picking it up — it saves two people doing the same work.
Fork the repository and make your change on a branch.
Open a pull request that references the issue number.