Re: [Numpy-discussion] StackOverflow documentation

2016-07-21 Thread josef . pktd 
On Thu, Jul 21, 2016 at 3:10 PM, Pauli Virtanen  wrote:
> Thu, 21 Jul 2016 16:24:15 +0200, mail kirjoitti:
> [clip]
>> Since it is run by the community, perhaps it's not a bad idea to
>> encourage people to share their examples.
>
> I would perhaps rather encourage people to improve the "Numpy User Guide"
> or the main documentation. Of course, working on that requires a somewhat
> different level of committment than editing what's essentially
> Stackexchange-provided wiki (where content gets relicensed with
> attribution clauses where you have to reference stackexchange and not the
> original author directly).


The way it looks right now, it is more of an example collection by
topic, similar to the old scipy wiki examples for numpy.
http://stackoverflow.com/documentation/python/196/comprehensions#t=201607212153155953853

It doesn't look like it will be a substitute for proper API
documentation, docstrings with numpy standard.
Longer examples or recipes on stackoverflow also have the problem that
code doesn't have a different license and falls under the
documentation license.
So, I don't think it will become a substitute for good notebook or
blog post examples either.

(license is the usual one way street, they copy, we cannot copy back
under our license)

Josef

>
> --
> Pauli Virtanen
>
> ___
> NumPy-Discussion mailing list
> NumPy-Discussion@scipy.org
> https://mail.scipy.org/mailman/listinfo/numpy-discussion
___
NumPy-Discussion mailing list
NumPy-Discussion@scipy.org
https://mail.scipy.org/mailman/listinfo/numpy-discussion

Re: [Numpy-discussion] StackOverflow documentation

2016-07-21 Thread Pauli Virtanen 
Thu, 21 Jul 2016 16:24:15 +0200, mail kirjoitti:
[clip]
> Since it is run by the community, perhaps it's not a bad idea to
> encourage people to share their examples.

I would perhaps rather encourage people to improve the "Numpy User Guide" 
or the main documentation. Of course, working on that requires a somewhat 
different level of committment than editing what's essentially 
Stackexchange-provided wiki (where content gets relicensed with 
attribution clauses where you have to reference stackexchange and not the 
original author directly).

-- 
Pauli Virtanen

___
NumPy-Discussion mailing list
NumPy-Discussion@scipy.org
https://mail.scipy.org/mailman/listinfo/numpy-discussion

Re: [Numpy-discussion] StackOverflow documentation

2016-07-21 Thread mail 
>> StackOverflow now also has documentation, and there already is a NumPy tag:
>>
>> http://stackoverflow.com/documentation/numpy
>>
>> Not sure what, if anything, do we want to do with this, nor how to handle
>> not having to different sources with the same information. Any thoughts?

>From what I understand, it's not meant to replace real documentation. It's 
>rather a collection of crowd-sourced instructive examples with explanations:

https://stackoverflow.com/tour/documentation

Since it is run by the community, perhaps it's not a bad idea to encourage 
people to share their examples.

Cheers,

Bartosz
___
NumPy-Discussion mailing list
NumPy-Discussion@scipy.org
https://mail.scipy.org/mailman/listinfo/numpy-discussion

Re: [Numpy-discussion] StackOverflow documentation

2016-07-21 Thread Charles R Harris 
On Thu, Jul 21, 2016 at 5:47 AM, Jaime Fernández del Río <
jaime.f...@gmail.com> wrote:

> StackOverflow now also has documentation, and there already is a NumPy tag:
>
> http://stackoverflow.com/documentation/numpy
>
> Not sure what, if anything, do we want to do with this, nor how to handle
> not having to different sources with the same information. Any thoughts?
>
>
That's interesting. Not sure what to do there, maybe upload some of our
documentation? I'm a bit worried as numpy documentation changes with every
release.

Chuck
___
NumPy-Discussion mailing list
NumPy-Discussion@scipy.org
https://mail.scipy.org/mailman/listinfo/numpy-discussion

[Numpy-discussion] StackOverflow documentation

2016-07-21 Thread Jaime Fernández del Río 
StackOverflow now also has documentation, and there already is a NumPy tag:

http://stackoverflow.com/documentation/numpy

Not sure what, if anything, do we want to do with this, nor how to handle
not having to different sources with the same information. Any thoughts?

Jaime

-- 
(\__/)
( O.o)
( > <) Este es Conejo. Copia a Conejo en tu firma y ayúdale en sus planes
de dominación mundial.
___
NumPy-Discussion mailing list
NumPy-Discussion@scipy.org
https://mail.scipy.org/mailman/listinfo/numpy-discussion