Re: [docs] [PATCH] manuals: mention license information in footer

Re: [docs] [PATCH] manuals: mention license information in footer

[Michael Opdenacker]

Greetings,

On 7/28/21 4:34 PM, Michael Opdenacker wrote:
> Previously, the license for the manuals was only
> stated in the SPDX headers at the beginning of source files
>
> Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
> ---
>  documentation/conf.py | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/documentation/conf.py b/documentation/conf.py
> index 6c6458fed7..8e15fdc869 100644
> --- a/documentation/conf.py
> +++ b/documentation/conf.py
> @@ -28,7 +28,7 @@ release = current_version
>  
>  # -- Project information -----------------------------------------------------
>  project = 'The Yocto Project \xae'
> -copyright = '2010-%s, The Linux Foundation' % datetime.datetime.now().year
> +copyright = '2010-%s, The Linux Foundation, CC-BY-SA-2.0-UK license' % datetime.datetime.now().year
>  author = 'The Linux Foundation'


I have a few follow-up questions...

  * Shouldn't we have a quick section at the beginning of the
    documentation mentioning the license information?
  * Shouldn't the copyright owner be "The Yocto Project and OpenEmbedded
    community", as in the Linux kernel documentation? Though the
    contributions funded by the Linux Foundation are very big, there are
    other contributors and we don't ask them to transfer their copyright
    to the LF.

Thanks in advance for your advise.
Cheers
Michael.

-- 
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

Re: [docs] [PATCH] manuals: mention license information in footer

[Michael Opdenacker]

On 7/28/21 4:39 PM, Michael Opdenacker wrote:
> Greetings,
>
> On 7/28/21 4:34 PM, Michael Opdenacker wrote:
>> Previously, the license for the manuals was only
>> stated in the SPDX headers at the beginning of source files
>>
>> Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
>> ---
>>  documentation/conf.py | 2 +-
>>  1 file changed, 1 insertion(+), 1 deletion(-)
>>
>> diff --git a/documentation/conf.py b/documentation/conf.py
>> index 6c6458fed7..8e15fdc869 100644
>> --- a/documentation/conf.py
>> +++ b/documentation/conf.py
>> @@ -28,7 +28,7 @@ release = current_version
>>  
>>  # -- Project information -----------------------------------------------------
>>  project = 'The Yocto Project \xae'
>> -copyright = '2010-%s, The Linux Foundation' % datetime.datetime.now().year
>> +copyright = '2010-%s, The Linux Foundation, CC-BY-SA-2.0-UK license' % datetime.datetime.now().year
>>  author = 'The Linux Foundation'
>
> I have a few follow-up questions...
>
>   * Shouldn't we have a quick section at the beginning of the
>     documentation mentioning the license information?
>   * Shouldn't the copyright owner be "The Yocto Project and OpenEmbedded
>     community", as in the Linux kernel documentation? Though the
>     contributions funded by the Linux Foundation are very big, there are
>     other contributors and we don't ask them to transfer their copyright
>     to the LF.
>
> Thanks in advance for your advise.


Any thoughts on this?
Thanks in advance,
Michael.

-- 
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

Re: [docs] [PATCH] manuals: mention license information in footer

[Michael Opdenacker]

Richard, all,

On 7/30/21 7:13 PM, Michael Opdenacker wrote:
> On 7/28/21 4:39 PM, Michael Opdenacker wrote:
>> Greetings,
>>
>> On 7/28/21 4:34 PM, Michael Opdenacker wrote:
>>> Previously, the license for the manuals was only
>>> stated in the SPDX headers at the beginning of source files
>>>
>>> Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
>>> ---
>>>  documentation/conf.py | 2 +-
>>>  1 file changed, 1 insertion(+), 1 deletion(-)
>>>
>>> diff --git a/documentation/conf.py b/documentation/conf.py
>>> index 6c6458fed7..8e15fdc869 100644
>>> --- a/documentation/conf.py
>>> +++ b/documentation/conf.py
>>> @@ -28,7 +28,7 @@ release = current_version
>>>  
>>>  # -- Project information -----------------------------------------------------
>>>  project = 'The Yocto Project \xae'
>>> -copyright = '2010-%s, The Linux Foundation' % datetime.datetime.now().year
>>> +copyright = '2010-%s, The Linux Foundation, CC-BY-SA-2.0-UK license' % datetime.datetime.now().year
>>>  author = 'The Linux Foundation'
>> I have a few follow-up questions...
>>
>>   * Shouldn't we have a quick section at the beginning of the
>>     documentation mentioning the license information?
>>   * Shouldn't the copyright owner be "The Yocto Project and OpenEmbedded
>>     community", as in the Linux kernel documentation? Though the
>>     contributions funded by the Linux Foundation are very big, there are
>>     other contributors and we don't ask them to transfer their copyright
>>     to the LF.
>>
>> Thanks in advance for your advise.
>
> Any thoughts on this?
> Thanks in advance,
> Michael.


Would you have an idea on this? At least, can I merge the change I'm
proposing?
Thanks in advance,
Michael.

-- 
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

Re: [docs] [PATCH] manuals: mention license information in footer

[Richard Purdie]

On Wed, 2021-08-04 at 15:41 +0200, Michael Opdenacker wrote:
> Richard, all,
> 
> On 7/30/21 7:13 PM, Michael Opdenacker wrote:
> > On 7/28/21 4:39 PM, Michael Opdenacker wrote:
> > > Greetings,
> > > 
> > > On 7/28/21 4:34 PM, Michael Opdenacker wrote:
> > > > Previously, the license for the manuals was only
> > > > stated in the SPDX headers at the beginning of source files
> > > > 
> > > > Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
> > > > ---
> > > >  documentation/conf.py | 2 +-
> > > >  1 file changed, 1 insertion(+), 1 deletion(-)
> > > > 
> > > > diff --git a/documentation/conf.py b/documentation/conf.py
> > > > index 6c6458fed7..8e15fdc869 100644
> > > > --- a/documentation/conf.py
> > > > +++ b/documentation/conf.py
> > > > @@ -28,7 +28,7 @@ release = current_version
> > > >  
> > > > 
> > > > 
> > > > 
> > > >  # -- Project information -----------------------------------------------------
> > > >  project = 'The Yocto Project \xae'
> > > > -copyright = '2010-%s, The Linux Foundation' % datetime.datetime.now().year
> > > > +copyright = '2010-%s, The Linux Foundation, CC-BY-SA-2.0-UK license' % datetime.datetime.now().year
> > > >  author = 'The Linux Foundation'
> > > I have a few follow-up questions...
> > > 
> > >   * Shouldn't we have a quick section at the beginning of the
> > >     documentation mentioning the license information?
> > >   * Shouldn't the copyright owner be "The Yocto Project and OpenEmbedded
> > >     community", as in the Linux kernel documentation? Though the
> > >     contributions funded by the Linux Foundation are very big, there are
> > >     other contributors and we don't ask them to transfer their copyright
> > >     to the LF.
> > > 
> > > Thanks in advance for your advise.
> > 
> > Any thoughts on this?
> > Thanks in advance,
> > Michael.
> 
> 
> Would you have an idea on this? At least, can I merge the change I'm
> proposing?

We probably should have something mentioning the license, yes and this
change is ok.

We can't just say it is community owned because it is not, much of the 
docs work was done through the Linux Foundation and they do technically 
own that copyright, not the community. If any contributor wants to add
their copyright we can do that, or we can probably change it to "Linux
Foundation and The Yocto Project and OpenEmbedded community".

Cheers,

Richard

Re: [docs] [PATCH] manuals: mention license information in footer

[Michael Opdenacker]

Richard,

On 8/4/21 3:48 PM, Richard Purdie wrote:
> We probably should have something mentioning the license, yes and this
> change is ok.
>
> We can't just say it is community owned because it is not, much of the 
> docs work was done through the Linux Foundation and they do technically 
> own that copyright, not the community. If any contributor wants to add
> their copyright we can do that, or we can probably change it to "Linux
> Foundation and The Yocto Project and OpenEmbedded community".


Thanks for your feedback. I'll merge the first change and propose a
quick subsection in the manual detailing the license.
Unless there are disagreements, I propose to stick to the LF as
copyright owner.

Cheers,
Michael.
-- 

Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

Re: [docs] [PATCH] manuals: mention license information in footer

[Michael Opdenacker]

Hi Richard,

On 8/4/21 4:02 PM, Michael Opdenacker wrote:
> Richard,
>
> On 8/4/21 3:48 PM, Richard Purdie wrote:
>> We probably should have something mentioning the license, yes and this
>> change is ok.
>>
>> We can't just say it is community owned because it is not, much of the 
>> docs work was done through the Linux Foundation and they do technically 
>> own that copyright, not the community. If any contributor wants to add
>> their copyright we can do that, or we can probably change it to "Linux
>> Foundation and The Yocto Project and OpenEmbedded community".
>
> Thanks for your feedback. I'll merge the first change and propose a
> quick subsection in the manual detailing the license.
> Unless there are disagreements, I propose to stick to the LF as
> copyright owner.


Eventually, I'll stick to what we have currently. The boilerplate
inserted at the end of each manual clearly states the license. That's
probably enough.

Cheers,

Michael.

-- 
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com