Skip to content

Exclude ODG graphics from RAT checks - #2029

Merged
elharo merged 2 commits into
masterfrom
i2028
Aug 4, 2026
Merged

Exclude ODG graphics from RAT checks#2029
elharo merged 2 commits into
masterfrom
i2028

Conversation

@elharo

@elharo elharo commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

fixes #2028

It is a binary file: While technically a zip archive of XML, OpenDocument formats are meant to be edited via GUI tools (like LibreOffice/OpenOffice), not hand-edited. It is standard practice in Apache projects to treat such rich-document formats as binaries.

License Headers break ODG: You cannot reliably inject standard Apache ALv2 text headers into the XML inside the ODG archive without risking file corruption or breaking the application that reads the ODG file.

Apache Policy: The Apache Software Foundation's policy on license headers explicitly states that files without a degree of creativity (like configuration files or generated diagrams) or binary files where adding a header would break the format do not require ALv2 headers.

@elharo
elharo marked this pull request as ready for review August 4, 2026 12:29

@gnodet gnodet left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Correct and well-scoped. The repo has one ODG file (src/site/xdoc/maven-resolver-deps.odg) which is a binary ZIP archive (OpenDocument Graphics) — it can't carry a license header. The **/*.odg glob is consistent with the existing **/*.key pattern in the RAT config.

This review was generated by an AI agent (Claude Code) and may contain inaccuracies. Please verify all suggestions before applying.

On behalf of gnodet

@elharo
elharo merged commit 3da66f1 into master Aug 4, 2026
23 checks passed
@elharo
elharo deleted the i2028 branch August 4, 2026 18:11
@github-actions github-actions Bot added this to the 2.0.22 milestone Aug 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ODG RAT

2 participants