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: arch...@mail-archive.com

Reply via email to