Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [ee4j-pmc] Copyright headers

TL;DR: you don't actually need to update the copyright header on an ongoing basis.

We have two choices for the header: one is a more traditional form that lists the actual name of one or more companies (legal entities), and one that is more generic. It's really up to the initial contributor and project team to decide which one to use.

Eclipse MicroProfile was on the bleeding edge of some changes we needed to make in our recommendations regarding legal documentation. There's been some further refinements, and I believe that it's settled enough now that I'll starting to more broadly disseminate this (I'm also tweaking the handbook content).

For starters (this is mostly for Kevin), we thought that we'd be using an SPDX format for notice files and put MicroProfile on that path. We determined that that this was actually not desireable (or, in fact, the intent of the format), and so have changed the requirement to use a more standard human-readable (e.g. Markdown) format.

The IP Advisory Committee recently decided that we don't need to separately list copyright holders, but instead can just refer to the project's Git logs as the source of information regarding authors and--by extension--copyright holders (the copyright holder is very often the author's employer). We've decided to manifest this as a statement in the NOTICE file which should include pointers to the canonical source code repositories (see the link below for an example).

We also decided to follow the The US Copyright Office recommendation that copyright holders use copyright notices that include the year of first publication of the work.  So, where we used to recommend a range of dates, it's now enough to just put the date of first publication and leave it at that. It's not wrong to include a date of the most recent contribution, but it's not required.

My understanding is that "All rights reserved" is legally meaningless. It's not strictly wrong to include it, it's just unnecessary.

I have an update to the Eclipse Project Handbook pending release either tomorrow or early next week. The information that's listed there is basically correct (except for the date range recommendation).

We have an experimental tool that generates templates for legal documentation:


We haven't added UI to change the project yet, so you have to change the id in the header to your project's id if you want it to, for example, pull up your project's description. It renders the NOTICE file as Markdown, because that's what we've observed that most people do. Any sort of human-readable format is acceptable.

It tends to do a reasonably good job, but if you notice anything that horribly, horribly wrong, let me know.

Wayne

On Thu, Apr 5, 2018 at 9:47 AM, Kevin Sutter <sutter@xxxxxxxxxx> wrote:
Just a quick follow-up to Mark's note since the MicroProfile project had the exact same type of questions when we first started out...  Our discussions with the EMO (Eclipse Mgmt Office) resulted in some of the changes that you found in the handbook.

We ended up with this...

/**********************************************************************
 * Copyright (c) 2017 Contributors to the Eclipse Foundation
 *
 * See the NOTICES file(s) distributed with this work for additional
 * information regarding copyright ownership.

And, then our NOTICE file(s) would have something along these lines...

Portions of this software were originally based on the following:
* microprofile.io bill of materials
  https://github.com/microprofile/microprofile-bom
  under Apache License, v2.0

SPDXVersion: SPDX-2.1
PackageName: Eclipse Microprofile
PackageHomePage: http://www.eclipse.org/microprofile
PackageLicenseDeclared: Apache-2.0

PackageCopyrightText: <text>
Ken Finnigan ken@xxxxxxxxxxxxxx,
Ivan St. Ivanov ivan.st.ivanov@xxxxxxxxx,
Kevin Sutter kwsutter@xxxxxxxxx,
Ondrej Mihalyi ondrej.mihalyi@xxxxxxxxx
</text>

In the case of the Oracle contributions, we need to leave the original Copyright as is for Oracle.  But, going forward with new changes, we can add a more generic Copyright for the Eclipse Foundation and then create the necessary NOTICE files to list out the additional contributors.  Sound good?


---------------------------------------------------
Kevin Sutter
STSM, MicroProfile and Java EE architect
e-mail:  sutter@xxxxxxxxxx     Twitter:  @kwsutter
phone: tl-553-3620 (office), 507-253-3620 (office)    
LinkedIn:
https://www.linkedin.com/in/kevinwsutter



From:        Mark Thomas <markt@xxxxxxxxxx>
To:        ee4j-pmc@xxxxxxxxxxx
Date:        04/05/2018 04:28 AM
Subject:        Re: [ee4j-pmc] Copyright headers
Sent by:        ee4j-pmc-bounces@xxxxxxxxxxx




Ignore me.

I've been pointed towards:

https://urldefense.proofpoint.com/v2/url?u=https-3A__www.eclipse.org_projects_handbook_-23ip-2Dcopyright-2Dheaders&d=DwIGaQ&c=jf_iaSHvJObTbx-siA1ZOg&r=R9dtOS3afYnRUmu_zogmh0VnVYl2tse_V7QBUA9yr_4&m=usL3BYbzBfjUtXAiYJBsCUh5foa1vSKvLLUmCedFhnI&s=te91vpZV_SL9DNe_-obywO7-xqh53KTpu-OkoWTMGp4&e=


that answers this question.

Sorry for the noise.

Mark


On 05/04/18 08:51, Mark Thomas wrote:
> Hi,
>
> I'm guessing the PMC list is the right venue for this discussion. Feel
> free to point me elsewhere if not.
>
> The imported files from Oracle contain copyright headers along these lines:
>
> Copyright (c) 2012, 2017 Oracle and/or its affiliates. All rights reserved.
>
>
> The question has arisen "How should the copyright header be updated when
> we start making changes to these files?"
>
> There are a number of factors:
>
> - Eclipse committers retain copyright in their own contributions.
> - Eclipse (probably) has copyright in the collective work that results
>   from the combination of the original contribution and the changes from
>   the Eclipse committers.
> - There may have been (I have no visibility) a copyright assignment when
>   the Oracle donated the code to Eclipse.
> - Other factors of which I am not aware.
>
>
> Looking at some other Eclipse projects it seems like updating the header
> as follows might be the way to go:
>
> Copyright (c) 2012, 2018 Oracle and/or its affiliates and others. All
> rights reserved.
>
> where the second copyright year is updated to the current year when the
> first modification is made in that year.
>
> Is the proposed approach above correct? If not, what is the correct
> approach and can the various projects be informed of the correct
> approach because, at the moment, individual projects are not approaching
> this in a consistent manner.
>
> Thanks,
>
> Mark
> _______________________________________________
> ee4j-pmc mailing list
> ee4j-pmc@xxxxxxxxxxx
> To change your delivery options, retrieve your password, or unsubscribe
> from this list, visit
>
https://urldefense.proofpoint.com/v2/url?u=https-3A__dev.eclipse.org_mailman_listinfo_ee4j-2Dpmc&d=DwIGaQ&c=jf_iaSHvJObTbx-siA1ZOg&r=R9dtOS3afYnRUmu_zogmh0VnVYl2tse_V7QBUA9yr_4&m=usL3BYbzBfjUtXAiYJBsCUh5foa1vSKvLLUmCedFhnI&s=DnBANczQsok6vKc5WQM4pJqQuMQfxCQeqwgXwFMTFAY&e=

_______________________________________________
ee4j-pmc mailing list
ee4j-pmc@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://urldefense.proofpoint.com/v2/url?u=https-3A__dev.eclipse.org_mailman_listinfo_ee4j-2Dpmc&d=DwIGaQ&c=jf_iaSHvJObTbx-siA1ZOg&r=R9dtOS3afYnRUmu_zogmh0VnVYl2tse_V7QBUA9yr_4&m=usL3BYbzBfjUtXAiYJBsCUh5foa1vSKvLLUmCedFhnI&s=DnBANczQsok6vKc5WQM4pJqQuMQfxCQeqwgXwFMTFAY&e=





_______________________________________________
ee4j-pmc mailing list
ee4j-pmc@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://dev.eclipse.org/mailman/listinfo/ee4j-pmc




--
Wayne Beaton
Director of Open Source Projects
The Eclipse Foundation

Back to the top