On Thursday, October 14, 2021, Joseph Fox-Rabinovitz <
jfoxrabinov...@gmail.com> wrote:

> I second that reinstating such a list would be extremely useful. My issue
> has been with the polynomial package, but the end result is the same.
>

There's a mostly relevant issue: https://github.com/numpy/numpy/issues/19420

András


>
>
> - Joe
>

> On Thu, Oct 14, 2021, 12:45 Melissa Mendonça <meliss...@gmail.com> wrote:
>
>> Hi Paul,
>>
>> Do you think having a page with the flat list of routines back, in
>> addition to the explanations, would solve this?
>>
>> - Melissa
>>
>> On Thu, Oct 14, 2021 at 1:34 PM Paul M. <pmma...@gmail.com> wrote:
>>
>>> Hi All,
>>>
>>> The documentation of Numpy's submodules  used to have a fairly standard
>>> structure as shown here in the 1.16 documentation:
>>>
>>>   https://docs.scipy.org/doc/numpy-1.16.1/reference/routines.random.html
>>>
>>> Now the same page in the API documentation looks like this:
>>>
>>>   https://numpy.org/doc/stable/reference/random/index.html
>>>
>>> While I appreciate the expository text in the new documentation about
>>> how the generators work, this new version is much less useful as a
>>> reference to the API.  It seems like it might fit better in the user manual
>>> rather than the API reference.
>>>
>>> From my perspective it seems like the new version of the documentation
>>> is harder to navigate in terms of finding information quickly (more
>>> scrolling, harder to get a bird's eye view of functions in various
>>> submodules, etc).
>>>
>>> Has anyone else had a similar reaction to the changes? I teach a couple
>>> of courses in scientific computing and bioinformatics and my students seem
>>> to also struggle to get a sense of what the different modules offer based
>>> on the new version of the documentation. For now, I'm referring them to the
>>> old (1.70) reference manuals as a better way to get acquainted with the
>>> libraries.
>>>
>>> Cheers,
>>> Paul Magwene
>>> _______________________________________________
>>> NumPy-Discussion mailing list -- numpy-discussion@python.org
>>> To unsubscribe send an email to numpy-discussion-le...@python.org
>>> https://mail.python.org/mailman3/lists/numpy-discussion.python.org/
>>> Member address: meliss...@gmail.com
>>>
>> _______________________________________________
>> NumPy-Discussion mailing list -- numpy-discussion@python.org
>> To unsubscribe send an email to numpy-discussion-le...@python.org
>> https://mail.python.org/mailman3/lists/numpy-discussion.python.org/
>> Member address: jfoxrabinov...@gmail.com
>>
>
_______________________________________________
NumPy-Discussion mailing list -- numpy-discussion@python.org
To unsubscribe send an email to numpy-discussion-le...@python.org
https://mail.python.org/mailman3/lists/numpy-discussion.python.org/
Member address: arch...@mail-archive.com

Reply via email to