Skip to content

Conversation

@ppkarwasz
Copy link
Contributor

This is the vdr.xml equivalent of the changes introduced in #6. Therefore, it requires #6 to be merged first.

Copy link
Member

@vy vy left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What is the purpose of latest.xml, easy diff'ing?

@ppkarwasz
Copy link
Contributor Author

What is the purpose of latest.xml, easy diff'ing?

Exactly, the way we currently do it (new document at each update), you need to checkout the commit to see the differences.

@vy
Copy link
Member

vy commented Jan 29, 2025

@ppkarwasz, since version 2 was incorrectly bumped, can we override 2.xml instead of creating a new file and version?

@ppkarwasz ppkarwasz marked this pull request as ready for review August 17, 2025 11:43
- Removed URL references related to the abandoned
  [BOM Exchange API proposal](https://github.com/CycloneDX/transparency-exchange-api/tree/bomexchangeapi),
  which was never accepted.
- Our SBOMs have always only referenced `/cyclonedx/vdr.xml`,
  so these links were unused and unnecessary.

This cleanup simplifies the website structure and ensures we can take fuller advantage of version control.
- Restores version 1 of the VDR as `vdr.xml`, reverting
  the complex structure introduced in commit
  620e96c.
- This commit can be tagged as `vdr-1` for reference.
- Restores version 2 of the VDR as `vdr.xml`, making it easier
  to compare changes against version 1.
- This commit can be tagged as `vdr-2` for future reference.
- Updated `vdr.xml` to align with the proofread versioning details
  from PR #7.
- Introduced a `<metadata>` element to record contact information
  for the Apache Logging Services PMC and Security Team, as well as
  the timestamp of the last modification.
- Refreshed the `<updated>` timestamps in all modified `<vulnerability>` entries.
- Added inline comment with instructions on how to properly
  update and maintain the VDR file.
@ppkarwasz ppkarwasz force-pushed the doc/cyclonedx-vulnerability branch from e0c49f7 to 5296e96 Compare August 17, 2025 12:33
@ppkarwasz
Copy link
Contributor Author

Hi @vy,

I rebased this PR on top of the changes from #12, which simplified the VDR structure by removing the obsolete BOM Exchange API directory.

That should make verification easier: you only need to review commit 5296e96.

On versioning: I think we should release version 3, even though bumping to 2 in #2 was a mistake (since it only changed comments). Some (even if purely theoretical) consumers may already have recorded 2 as the latest VDR version, and re-issuing a different 2 would prevent them from picking up updates.

@ppkarwasz ppkarwasz requested a review from vy August 17, 2025 12:40
Update the contact information based on review feedback.
@ppkarwasz ppkarwasz merged commit e9ccda8 into cyclonedx Aug 22, 2025
ppkarwasz added a commit that referenced this pull request Aug 22, 2025
* feat: proofread CVE fix versions in `vdr.xml`

- Updated `vdr.xml` to align with the proofread versioning details
  from PR #7.
- Introduced a `<metadata>` element to record contact information
  for the Apache Logging Services PMC and Security Team, as well as
  the timestamp of the last modification.
- Refreshed the `<updated>` timestamps in all modified `<vulnerability>` entries.
- Added inline comment with instructions on how to properly
  update and maintain the VDR file.

* fix: restore original update date for CVE-2021-45105

* fix: update contact information

Update the contact information based on review feedback.
ppkarwasz added a commit that referenced this pull request Aug 22, 2025
* feat: proofread CVE fix versions in `vdr.xml`

- Updated `vdr.xml` to align with the proofread versioning details
  from PR #7.
- Introduced a `<metadata>` element to record contact information
  for the Apache Logging Services PMC and Security Team, as well as
  the timestamp of the last modification.
- Refreshed the `<updated>` timestamps in all modified `<vulnerability>` entries.
- Added inline comment with instructions on how to properly
  update and maintain the VDR file.

* fix: restore original update date for CVE-2021-45105

* fix: update contact information

Update the contact information based on review feedback.
@vy vy deleted the doc/cyclonedx-vulnerability branch December 30, 2025 20:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants