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

Use static copyright years #126133

Closed
hugovk opened this issue Oct 29, 2024 · 11 comments · Fixed by python/devguide#1470
Closed

Use static copyright years #126133

hugovk opened this issue Oct 29, 2024 · 11 comments · Fixed by python/devguide#1470

Comments

@hugovk
Copy link
Member

hugovk commented Oct 29, 2024

Short version

Each January we update the PSF copyright years in the repo:

Copyright © 2001-2024 Python Software Foundation. All rights reserved.

2025 is approaching.

Can we get permission from the PSF to adopt a copyright that does not need updating every year?

I suggest something like one of the following:

Copyright © Python Software Foundation. All rights reserved.
Copyright © 2001 Python Software Foundation. All rights reserved.
Copyright © 2001-present Python Software Foundation. All rights reserved.

Longer version

Last year, we updated it in 15 places in 10 files:

Sometimes we miss a few and have to update them later:

Or we miss something, merge the fix a year late, which needs refixing:

And sometimes we backport these to (some) older branches, but other years don't:

Sometimes there's lots of duplicate PRs that end up closed and wasting everyone's time:

Not only is this tedious work, it is likely unnecessary. A lot of big projects have stopped updating copyright years: https://hynek.me/til/copyright-years/

For example:

Copyright (c) 2009 The Go Authors. All rights reserved.
Copyright (c) 2015 - present Microsoft Corporation
Copyright 2013 Netflix, Inc.
Copyright (c) Meta Platforms, Inc. and affiliates.
Copyright (c) Microsoft Corporation. All rights reserved.
Copyright (c) .NET Foundation and Contributors

These either have only have the first year, omit years altogether, or end with "present".

Can we do something similar?

Linked PRs

@Wulian233
Copy link
Contributor

Wulian233 commented Oct 30, 2024

+1
I also suggestion deleting the years of PSF 2001-20xx in other files. This should always be up to date. Currently, files with these rows are searched (200x 201x) over nearly 10~20 years. I don't think they need to repeat the statement because it's already stipulated in the LICENSE. But that's a lot of files to change (edit ~20)

example:
https://github.com/python/cpython/tree/main/Lib/email/iterators.py

2001-200x
https://github.com/search?q=repo:python/cpython 2001-200&type=code

2001-201x
https://github.com/search?q=repo:python/cpython 2001-201&type=code

@gpshead
Copy link
Member

gpshead commented Oct 31, 2024

IMNSHO lets just adopt this already. Do not update existing copyright dates in existing files.

Ex: From other your examples above - Google's policy was always "never touch the year" with the year of file creation or copyright statement addition being the standard. As noted in https://opensource.google/documentation/reference/releasing/preparing#license-headers

@hugovk
Copy link
Member Author

hugovk commented Oct 31, 2024

Do you mean leave them as-is, and stop updating them each year?

However, I expect we will still see many PRs from people who see "2001-2024" and want to help by updating to "2001-2025". It will be easy, though tedious, for us to close them, but at the expense of having wasted the time of contributors.

Or to remove the end years?

I think this is better, as I doubt we'll get PRs updating "2001" to "2001-2025". Here's a draft PR to illustrate: #126236.

@AA-Turner
Copy link
Member

From that draft PR -- seeing the version with '2024' removed as the end year leads me to slightly prefer the 'YYYY - present' option, especially in lists of several prior copyright assignments. Hugo's option 1 (no year) would also render this moot, though is slightly less consistent.

I would also suggest removing copyright comments from modules/files where the PSF is the only cited copyright holder, as this is simply duplicative information.

A

@gpshead
Copy link
Member

gpshead commented Nov 1, 2024

I would also suggest removing copyright comments from modules/files where the PSF is the only cited copyright holder, as this is simply duplicative information.

I wouldn't remove entire copyright statements from anywhere.

Hugo should reach out to the PSF (as copyright holder) for advice. Our goal is to simplify our life, have a policy to point to, and reduce toil.

We should codify said advice in our dev guide and simply reply to anyone attempting to modify copyright statements with a link to that documentation.

@hugovk
Copy link
Member Author

hugovk commented Nov 1, 2024

I've emailed PSF legal.

@hugovk
Copy link
Member Author

hugovk commented Nov 6, 2024

And the reply:


The first thing to understand is that copyright notices are optional/informational. There was a time that copyright owners were required to include a notice in order for their copyrights to be protected; by international treaty, this requirement has been abolished. So the form of your copyright notices will not impact the rights of the copyright owner.

Copyright notices can, however, still perform a useful informative role. According to the US copyright office, the elements of a valid copyright notice are:

  • The copyright symbol ©; the word “copyright”; or the abbreviation “copr.”;
  • The year of first publication of the work; and
  • The name of the copyright owner.

Example: © 2024 John Doe

For a work that's published only once, the year of first publication is a simple matter. A file in an open source project, on the other hand, is essentially an accretion of revisions or derivative works, each with different years of first publication. This is why you see multiple dates or date ranges in the corresponding copyright notices. For example, if a file was created in 2015 and revised in 2017, 2018, 2019, and 2022, you might render the copyright notice in one of the following ways:

  • © 2015, 2017-2019, 2022 John Doe
  • © 2015, 2017, 2018, 2019, 2022 John Doe

It's probably fairly common in such cases to use "2015-2022" as the date range, although this provides somewhat less information about the dates of first publication of the various revisions, and arguably implies incorrectly that the file was revised in each of the years in the range.

It doesn't make particular sense to update notices to add the present year at the end of the date range in every copyright notice, regardless of whether the corresponding file has been updated recently. But it's also not going to impact anyone's rights, nor is using "-present" instead.

So I think both of the formats you propose that include the year would be fine. I would not recommend leaving out the year of first publication entirely, as it's one of the elements of a valid copyright notice.

I'll also note that "Python Software Foundation" is probably not an accurate statement of the author(s) of PSF projects, since PSF does not (as far as I know) require copyright assignment. That said, it's also impractical and error-prone to include notices for all of the authors of a file. Some common alternatives are "FOO Project Contributors" or "The authors listed in CONTRIBUTORS." None of these are ideal, because they either don't actually name the authors, or they may become inaccurate as an author's contributions disappear over time.

In short, there's no ideal solution, but thankfully notices aren't that important. Pick something reasonable and do your best to stick to it.

@hugovk
Copy link
Member Author

hugovk commented Nov 6, 2024

Therefore I propose #126236 as it is. (Left as draft to avoid pinging the CODEOWNERS.)

We should codify said advice in our dev guide and simply reply to anyone attempting to modify copyright statements with a link to that documentation.

Good idea. Let's do this after merge.

@hugovk
Copy link
Member Author

hugovk commented Nov 12, 2024

I've merged #126236 and opened python/devguide#1470.

@malemburg
Copy link
Member

@hugovk: Before making such changes and releasing the distributions with these changes, please ask the PSF Board for approval. They are the only ones who have the authority to change license texts and possibly even PSF copyright notices (since they are being referred to in the PSF license). Thanks.

@eximious
Copy link

The PSF Legal list is monitored by PSF staff (including myself) and is the correct path for these kinds of issues. Topics that need full board involvement get sent up and ones that don't need full board involvement get decided there, either without or without legal counsel depending on the topic. In this particular instance, we did loop in counsel to make sure that the PSF is fulfilling our legal duty as copyright holders.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

6 participants