Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clean up isDeprecated values #1864

Merged
merged 6 commits into from
Mar 8, 2023
Merged

Clean up isDeprecated values #1864

merged 6 commits into from
Mar 8, 2023

Conversation

BassCoder2808
Copy link
Contributor

Fixes #1545
Removed the isDeprecated attribute from the XML Schema Definition file. xml-fields.md contains isDeprecated definition which was also removed now.

Copy link
Member

@swinslow swinslow left a comment

Choose a reason for hiding this comment

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

Thanks @BassCoder2808! I have a couple of comments, please take a look.

@goneall Feel free to weigh in if you would like. Otherwise, this looks good to me once @BassCoder2808 makes the requested changes.

@@ -44,17 +44,19 @@ Within the .xml file, the first and last lines of the file should be the followi
The main tag used to define the license or exception is, unsurprisingly, **`<license>`** or **`<exception>`**. All of the remaining content will be enclosed within a `<license></license>` or `<exception></exception>` pair of tags.

There are two mandatory attributes for every `<license>` and `<exception>` tag:
* `licenseId`: the unique SPDX Identifier for the license; should be identical to the filename
Copy link
Member

Choose a reason for hiding this comment

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

Throughout this PR, it looks like in addition to removing the isDeprecated documentation, this PR is also changing all of the bullet types from * to -.

Are these changes needed, since both bullet types are valid for Markdown lists on GitHub?

If not needed, could you please revise the PR so that the only change is removing the isDeprecated documentation? Would prefer to keep the edits limited so that it's clear what's being changed here.


- `isOsiApproved` (for licenses, not exceptions): either "true" or "false" based on whether this license has been approved by the [Open Source Initiative](https://opensource.org/licenses/alphabetical)
- `listVersionAdded`: in which release version of the SPDX License List was the license first added, e.g. "3.19".
- Typically you'll check the currently-released version at https://spdx.org/licenses/ and increment the minor version by 1 for a new license.

Finally, if the license ID has been deprecated, two additional attributes should be included:
Copy link
Member

Choose a reason for hiding this comment

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

Note that this line should also be changed to reference "one additional attribute" instead of "two additional attributes"

Copy link
Member

@goneall goneall left a comment

Choose a reason for hiding this comment

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

The schema changes look good to me.

Thanks @BassCoder2808

@BassCoder2808 BassCoder2808 requested a review from swinslow March 8, 2023 17:45
Copy link
Member

@swinslow swinslow left a comment

Choose a reason for hiding this comment

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

LGTM, thanks again @BassCoder2808!

@swinslow swinslow merged commit e5286a0 into spdx:main Mar 8, 2023
@swinslow swinslow added this to the 3.21 milestone Mar 8, 2023
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.

Clean up isDeprecated values
3 participants