[Python-ideas] CC0 for Python Documentation

[M.-A. Lemburg]

On 22.11.2013 15:10, anatoly techtonik wrote:
> On Fri, Nov 22, 2013 at 4:10 PM, M.-A. Lemburg <mal at egenix.com> wrote:
>>
>>> CC0 is a way to free public works from legal burden:
>>> https://creativecommons.org/about/cc0
>>>
>>> Here is the reasoning why people do this:
>>> https://creativecommons.org/tag/cc0
>>>
>>> At first I thought about CC-BY, but then realized that no
>>> authorship is respected. As you may see here -
>>> http://docs.python.org/3/copyright.html - PSF is the sole
>>> owner of the docs with no reference to the work of people
>>> who have contributed. No wonder that there is not much
>>> motivation to collaborate.
>>
>> The documentation is distributed under the same license
>> terms as Python itself. Credits are included in the
>> Misc/ACKS file and the patch history is both on the
>> tracker and the Mercurial log.
> 
> This information is not accessible. Nobody knows where this
> Misc/ACKS file is located and nobody will go look for it. On
> the other hand, clicking copyright string is an easy action.
> Mercurial log also only makes sense if it is analysed
> http://www.red-bean.com/svnproject/contribulyzer/
> 
>> We don't treat documentation as separate from the code itself.
>> Both go together hand in hand.
> 
> That's good only for reference part. All other parts are largely
> outdated, incomplete, lack tutorials and examples. That
> happens, because docs are written by coders the same way
> as code, and not by users for users.

There are plenty alternatives around in form of books,
websites with tutorials, videos, podcasts, Q&As, then
there are the cookbook, the topic guides, blogs, etc.
if you don't like to use the official documentation.

https://wiki.python.org/moin/Documentation

I'm sure some of those don't require to sign a contrib
agreement, so you can contribute there. Or you can setup
your own website for this purpose. Plenty of options,
I'd say, for someone who wants to contribute something.

-- 
Marc-Andre Lemburg
eGenix.com

Professional Python Services directly from the Source  (#1, Nov 22 2013)
>>> Python Projects, Consulting and Support ...   http://www.egenix.com/
>>> mxODBC.Zope/Plone.Database.Adapter ...       http://zope.egenix.com/
>>> mxODBC, mxDateTime, mxTextTools ...        http://python.egenix.com/
________________________________________________________________________

::::: Try our mxODBC.Connect Python Database Interface for free ! ::::::

   eGenix.com Software, Skills and Services GmbH  Pastor-Loeh-Str.48
    D-40764 Langenfeld, Germany. CEO Dipl.-Math. Marc-Andre Lemburg
           Registered at Amtsgericht Duesseldorf: HRB 46611
               http://www.egenix.com/company/contact/