[Python-ideas] Add citation() to site.py

[Guido van Rossum]

I replied from my cell phone but it bounced (again :-( ). I wrote:

"""
I think this should be in the docs, not in the code. (The reason to
have copyright() in the code is purely legalistic.)
"""

But I would be much more interested in hearing what the citation text
should be before discussing how to add it to the code. (I still think
adding it to the code isn't very helpful -- we can't add this to the
older versions of code that people are likely to be using.)


On Thu, Mar 17, 2016 at 2:38 PM, Steve Dower <steve.dower at python.org> wrote:
> On 17Mar2016 1335, Ethan Furman wrote:
>>
>> On 03/17/2016 01:32 PM, Nathaniel Smith wrote:
>>
>>  > One way to think about it is that providing a preferred citation is
>>  > useful for folks who want to cite, and folks who don't want to cite
>>  > will ignore it.
>>
>> I would also think that citing the software increases the ease of
>> duplicating the results.
>
>
> Afraid not. Posting a requirements.txt or a conda spec file would be far
> more valuable for this, or these days sharing a Jupyter Notebook with the
> code and dependency-spec embedded.
>
> It's also arguable as to how valuable reproducing the results in an
> identical environment actually is. Yes, your code runs on a different
> machine, but if your "research" is code then you are a developer, not a
> scientist. Someone actually needs to implement the idea in a different
> environment (and ideally they know just how it differs) to demonstrate that
> it is an actual result and not just a fluke.
>
> Cheers,
> Steve
>
> _______________________________________________
> Python-ideas mailing list
> Python-ideas at python.org
> https://mail.python.org/mailman/listinfo/python-ideas
> Code of Conduct: http://python.org/psf/codeofconduct/



-- 
--Guido van Rossum (python.org/~guido)