On Thu, Oct 14, 2021 at 10:36 AM 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. > > Agree. As a knowledgeable user, I like short and sweet for reference purposes. Ideally, there would be an easy way to get to the basic facts, and then access extra explanatory material if needed.
Chuck
_______________________________________________ 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
