Skip to content

Conversation

@jkowalleck
Copy link
Member

@jkowalleck jkowalleck commented Jun 16, 2025

Refactored metadata.distribution to be more verbose in its name, and made it more versatile by converting it to an "object" with "TLP" as a property.

caused by #603 (comment)

@jkowalleck jkowalleck added this to the 1.7 milestone Jun 16, 2025
@jkowalleck jkowalleck requested a review from a team as a code owner June 16, 2025 09:42
@jkowalleck
Copy link
Member Author

@prabhu @anthonyharrison what do you think, does this refactor make sense to you?

Signed-off-by: Jan Kowalleck <[email protected]>
@jkowalleck jkowalleck changed the title refactor: metadata distribution object [DRAFT] refactor: metadata distribution object Jun 16, 2025
@jkowalleck jkowalleck changed the title [DRAFT] refactor: metadata distribution object [DRAFT] refactor: metadata distribution to be an object Jun 16, 2025
"title": "Distribution",
"description": "The Traffic Light Protocol (TLP) classification that controls the sharing and distribution of the data that the BOM describes.",
"$ref": "#/definitions/tlpClassification"
"distributionConstraints": {
Copy link
Contributor

Choose a reason for hiding this comment

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

How about distributionTerms or sharingPolicies rather than constraints?

message Metadata {
message DistributionConstraints {
// The Traffic Light Protocol (TLP) classification that controls the sharing and distribution of the data that the BOM describes.
optional TlpClassification tlp = 1;
Copy link
Contributor

Choose a reason for hiding this comment

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

tlpClassification or tlpLabel is a bit verbose but could be easy to understand without the need for a help text.

Signed-off-by: Jan Kowalleck <[email protected]>
@jkowalleck jkowalleck changed the title [DRAFT] refactor: metadata distribution to be an object refactor: metadata distribution to be an object Sep 3, 2025
@jkowalleck
Copy link
Member Author

@stevespringett what do you think? should we merge this one?
it is not a change to the spec, but an improvement for the implementations.

@stevespringett
Copy link
Member

Much more flexible @jkowalleck

@jkowalleck
Copy link
Member Author

@prabhu thank you for your suggestion, the implementation was changed accordingly.

@jkowalleck jkowalleck merged commit f822afc into 1.7-dev Sep 4, 2025
9 checks passed
@jkowalleck jkowalleck mentioned this pull request Sep 4, 2025
stevespringett added a commit that referenced this pull request Oct 21, 2025
## Fixed

* XML schema: add type for `ComponentData` sub-elements ([#600] via
[#601])
* JSON schema: added the correct `deprecated` mark for already
deprecated structures (via [a973a6b])

## Deprecated

* Deprecated various fields and structures related to _cryptographic
transparency_ - _CBOM_ . (via [#657])
Use the newly added structures and fields for detailing the information
instead.

## Changed

* Extended the scope of _formulations_. (via [#647])
From now on, _formulations_ may be used to describe how any referencable
object within the BOM came together, including components, services,
metadata, declarations, or the BOM itself.
  Before, it was restricted to components and services.

## Added

* Support for _external components_ with _version-ranges_ ([#321] via
[#586])
* Support for _multiple_ SPDX License Expressions alongside with other
licenses ([#454] via [#582])
* Support for _Streebog hashing algorithm_ ([#485] via [#525])
* Support for license expression _details and properties_ ([#549],
[#554] via [#599])
* Support for expressing BOM distribution constraints with the _Traffic
Light Protocol_ (TLP) in metadata ([#595] via [#604], [#653])
* Support for representing _patent information_ ([#596] via [#597])
* Support for _properties_ on external-references ([#608] via [#610])
* Support for _citations_ ([#630] via [#629])
* Support for detailing _cryptographic transparency_ information -
_CBOM_ ([#569] via [#657])

## Documentation

* Elaborated component classification "platform", explicitly expressed
that it includes just-in-time compilers and interpreters ([#233] via
[#647])
* Removed the term "optional" from the schema where the definition was
already unambiguous ([#616], [#649] via [#680])

## Test data

* Add test data for CycloneDX 1.7 implementations in XML, JSON, Protobuf


[#233]: #233
[#321]: #321
[#454]: #454
[#485]: #485
[#525]: #525
[#549]: #549
[#554]: #554
[#569]: #569
[#582]: #582
[#586]: #586
[#595]: #595
[#596]: #596
[#597]: #597
[#599]: #599
[#600]: #600
[#601]: #601
[#604]: #604
[#608]: #608
[#610]: #610
[#616]: #616
[#629]: #629
[#630]: #630
[#647]: #647
[#649]: #649
[#653]: #653
[#657]: #657
[#680]: #680
[a973a6b]:
a973a6b

----

- fixes #233
- fixes #321
- fixes #454
- fixes #485
- fixes #549
- fixes #554
- fixes #595
- fixes #596
- fixes #600
- fixes #608
- fixes #629
- fixes #616 
- fixes #649
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.

4 participants