Skip to content

Add documentation for SPDX license expression CEL functions#2113

Merged
nscuro merged 1 commit intomainfrom
spdx-expression-policy-funcs-docs
Mar 28, 2026
Merged

Add documentation for SPDX license expression CEL functions#2113
nscuro merged 1 commit intomainfrom
spdx-expression-policy-funcs-docs

Conversation

@nscuro
Copy link
Copy Markdown
Member

@nscuro nscuro commented Mar 27, 2026

Description

Adds documentation for SPDX license expression CEL functions.

Addressed Issue

Relates to #872

Additional Details

API server PR: DependencyTrack/hyades-apiserver#1947

Checklist

  • I have read and understand the contributing guidelines
  • This PR fixes a defect, and I have provided tests to verify that the fix is effective
  • This PR implements an enhancement, and I have provided tests to verify that it works as intended
  • This PR introduces changes to the database model, and I have updated the migration changelog accordingly
  • This PR introduces new or alters existing behavior, and I have updated the documentation accordingly

@nscuro nscuro added this to the 0.7.0 milestone Mar 27, 2026
Copilot AI review requested due to automatic review settings March 27, 2026 18:45
@nscuro nscuro added the documentation Improvements or additions to documentation label Mar 27, 2026
@owasp-dt-bot
Copy link
Copy Markdown

owasp-dt-bot commented Mar 27, 2026

Snyk checks have passed. No issues have been found so far.

Status Scan Engine Critical High Medium Low Total (0)
Open Source Security 0 0 0 0 0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds end-user documentation for new CEL helper functions that operate on SPDX license expression strings in policy compliance expressions, supporting issue #872 and corresponding API server changes.

Changes:

  • Added example policies for SPDX license-expression allowlisting and rejecting ambiguous (AND/OR) expressions.
  • Added a new “SPDX License Expressions” section describing semantics (case handling, WITH/exceptions).
  • Extended the function reference with spdx_expr_* function documentation and examples.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/usage/policy-compliance/expressions.md Outdated
@nscuro nscuro force-pushed the spdx-expression-policy-funcs-docs branch from 90ca367 to 162982e Compare March 27, 2026 23:47
Signed-off-by: nscuro <nscuro@protonmail.com>
@nscuro nscuro force-pushed the spdx-expression-policy-funcs-docs branch from 162982e to 5af9957 Compare March 28, 2026 00:29
@nscuro nscuro merged commit 8cf31a0 into main Mar 28, 2026
5 checks passed
@nscuro nscuro deleted the spdx-expression-policy-funcs-docs branch March 28, 2026 12:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants