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

Add MulanPSL-2.0 support. #127

Merged
merged 3 commits into from
Jul 23, 2022
Merged

Add MulanPSL-2.0 support. #127

merged 3 commits into from
Jul 23, 2022

Conversation

jmjoy
Copy link
Member

@jmjoy jmjoy commented Jul 21, 2022

No description provided.

Pattern string `yaml:"pattern"`
SpdxID string `yaml:"spdx-id"`
CopyrightOwner string `yaml:"copyright-owner"`
CopyrightSoftware string `yaml:"copyright-software"`
Copy link
Member Author

Choose a reason for hiding this comment

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

Add this field because MulanPSL-2.0 header require a [software] placeholder.

Copy link
Member

Choose a reason for hiding this comment

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

What is the difference between owner and software?
These seem untypical concepts.

Copy link
Member Author

Choose a reason for hiding this comment

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

What is the difference between owner and software? These seem untypical concepts.

[owner] is the author of the software, and [software] is the name of the software.

Copy link
Member

Choose a reason for hiding this comment

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

Is it the only license having this special definition?

Copy link
Member Author

Choose a reason for hiding this comment

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

I searched for a round of license headers and found that only gpl-3.0 header receive an optional software name.

Because the header check uses FindStringIndex to match, and the software name of the header of the MulanPSL-2.0 protocol is just at the top, so if this placeholder is removed, the header check should be successful.

Copy link
Member Author

Choose a reason for hiding this comment

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

Or maybe move the name to the top level?

Copy link
Member

Choose a reason for hiding this comment

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

@kezhenxu94 should be better to provide suggestions on codes. CopyrightSoftware seems not a very good name.

Copy link
Member

Choose a reason for hiding this comment

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

OK, two things

  1. Please name this variable as name. The name of the project is very clear. I think.

name is somewhat vague to me because it's under header.license

header: # <1>
  license:
    name: ... # here

So it may read like "header license's name".

What about prefixing with software or project like softwareName or projectName.

  1. Document should be updated, https://github.com/apache/skywalking-eyes#configurations.

@kezhenxu94 What do you think? What do you suggest to change the document index? Use <4> for name, and change the followings.

Both is ok. Let's use 4 for name to keep the orders

Copy link
Member

Choose a reason for hiding this comment

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

Or maybe move the name to the top level?

Adding a top-level field is ok in this case but

  • this field is only used in header command so we have no idea how to prevent it being used in other places (now or future)
  • if the field is used in other places we have no idea how to differentiate them if they have different values by any chance.
  • being top-level means it has wider impact and risk of incompatibility when modified

Copy link
Member Author

Choose a reason for hiding this comment

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

OK, two things

  1. Please name this variable as name. The name of the project is very clear. I think.

name is somewhat vague to me because it's under header.license

header: # <1>
  license:
    name: ... # here

So it may read like "header license's name".

What about prefixing with software or project like softwareName or projectName.

  1. Document should be updated, https://github.com/apache/skywalking-eyes#configurations.

@kezhenxu94 What do you think? What do you suggest to change the document index? Use <4> for name, and change the followings.

Both is ok. Let's use 4 for name to keep the orders

I think this is OK

@kezhenxu94 kezhenxu94 added this to the 0.5.0 milestone Jul 21, 2022
@jmjoy jmjoy marked this pull request as ready for review July 21, 2022 12:19
@jmjoy jmjoy requested review from kezhenxu94 and wu-sheng July 23, 2022 02:59
README.md Outdated Show resolved Hide resolved
@jmjoy jmjoy requested a review from wu-sheng July 23, 2022 03:29
@kezhenxu94 kezhenxu94 requested a review from fgksgf July 23, 2022 06:38
@wu-sheng wu-sheng merged commit d546665 into apache:main Jul 23, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants