Generated files with code snippets including copyright information causing problems. #834

schmidtw · 2023-09-25T23:57:35Z

Hello, this is similar to #278 but in my case I have project documentation that includes automatically generated examples that we want copied verbatim and they include the copyright information in SPDX form automatically. Adding the wrappers can be a bit tedious and complex in some cases to maintain effectively & marking the file as excluded by .gitignore is also problematic - we want the file to be easy to update and maintain git.

Since I have the file marked in the dep5 file with the accurate information, it would extremely handy to be able to also tag it in that file as 'do not examine'.

The text was updated successfully, but these errors were encountered:

mxmehl · 2023-09-26T08:54:45Z

I'm not sure I fully understood your case. Does this FAQ item and the following (about ignoring parts of a file) help?

schmidtw · 2023-09-26T09:19:58Z

This is a very simple example of a scenario that can cause trouble: https://github.com/xmidt-org/shared-go/#golang-ci-workflow-sample

Effectively we have actions that generate html code that we specifically want to check in & not exclude. In that code, we generate examples that include suggested SPDX headers to help encourage compliance with ease. But needing to add labels to each file that requires this runs into to a few different problems:

For some formats (like JSON) this can be impossible.
For any sizable amount of documentation that is auto generated and committed back as part of a repo, the need to manually restore the tags is tedious and error prone.
Automation of inserting these tags may pose challenges of their own.
From a compliance perspective, I want my org to embrace this workflow to the fullest; but the more tedious work there is, the larger the push-back on the entire effort. Friction yields failure to adopt, unfortunately.

We already have a pretty well though out dep5 file that describes the majority of how a project should be governed. The problem isn't lack of any copyright information in the file, it's simply confusing the tool. Providing a number of ways to handle difficult areas is one of the strengths reuse has. Extending it a bit to make dealing with generated code as easy as dealing with an image is valuable.

I'm aware that I can mark all the files in the .gitignore file, but that dilutes protections it brings because people just get in the habit of adding -f to force everything & then not thinking twice about the likely mistake they're going to make.

schmidtw · 2023-10-20T20:19:35Z

This is another example of where it would be ideal to be able to use dep5 to ignore the contents:
https://github.com/xmidt-org/retry/blob/main/NOTICE since we already have an entry https://github.com/xmidt-org/retry/blob/47b368ed0b4df48b9d5586270aca593d52140c5b/.reuse/dep5#L6

(Just documenting use cases of where this is handy.)

github-actions · 2025-05-17T03:16:12Z

Thank you for your time and contributions! Unfortunately, this issue has been inactive for quite a while which means we probably can't manage the time to deal with it. That's why we're marking it as stale. We want to keep things tidy and focus on active discussions, but we’re always happy to revisit if this is still relevant!

If you’d like to keep this open, please add a comment to let us know and remove the label stale. Otherwise, this issue will most likely be automatically closed soon.

github-actions bot added the stale label May 17, 2025

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Generated files with code snippets including copyright information causing problems. #834

Generated files with code snippets including copyright information causing problems. #834

Generated files with code snippets including copyright information causing problems. #834

Generated files with code snippets including copyright information causing problems. #834

Comments