Am 24.11.20 um 10:36 schrieb Christoph Hellwig:
On Tue, Nov 24, 2020 at 10:31:33AM +0100, Thorsten Leemhuis wrote:
Am 24.11.20 um 10:18 schrieb Christoph Hellwig:
On Tue, Nov 24, 2020 at 09:00:01AM +0100, Thorsten Leemhuis wrote:
For context: Patch 2 of this series adds a text to the Documentation/ directory
which (for now) uses "GPL-2.0+ OR CC-BY-4.0", as I want to make it easy and
attractive for others to base their work on it. I'm not strongly attached to
CC-BY-4.0, but it seemed like the best choice: it's designed for such usage and
afaics better than using MIT for text files.
And you've not Cced me on that patch 2 or patch 3, which makes Ccing
me on this pretty useless as I can't judge the context.
Argh, sorry, slipped through. You can find it here:
https://lore.kernel.org/linux-doc/2f314e58cb14c1579f843f8c72bdb4bbb83ac20a.1606137108.git.li...@leemhuis.info/
FWIW, here it is for easy access (just sent with thunderbird instead of
git send-mail, hopefully should be enough for this):
So what is so special with this documentation that it needs a
(for the kernel tree) unusual license?
There is nothing special with this text, it's just that GPL is known to
not be really ideal for documentation. That makes it hard for people to
reuse parts of the docs outside of the kernel context, say in books or
on websites. But it IMHO would be good for us if others could simply use
this text as a base in such places. Otherwise they'd often face a
situation where they had to write something completely new themselves,
which afsics often leads to texts that can be incomplete, inaccurate or
actually missleading. That can lead to bad bug reports, which is
annoying both for reporters and kernel developers.
That's why I came up with the thought "make the text available under
more liberal license in addition to the GPLv2 is a good idea here". I
considered MIT, but from what I see CC-BY 4.0 is a way better choice for
documentation that is more known to authors.
And I hope others pick up the idea when they write new documentation for
the kernel, so maybe sooner or later it's not unusual anymore.
How to we make sure people
don't accidentally end up including things they can't?
Well, the license in only specified in the header and not visible in the
rendered HTML, which reduces the risk already. To make it even smaller I
could add something like this to the header:
```
In case you want to use this text under CC-BY-4.0, make sure to take the
plaintext version
straight from the Linux kernel sources as base. This is because
processed versions of this text (like one rendered to HTML or PDF) will
have text in them
that is taken from other files which that are not available under
CC-BY-4.0
license.
```
Ciao, Thorsten
