DOC: Additional ideas related to numpy-tutorials integration #19422
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
A couple of ideas related to #19191 and #19418
Adds a link to
numpy-tutorials
to the numpy docs nav-bar. This isn't critical, I just wanted to highlight this feature of the pydata sphinx theme in case we wanted to have the tutorials accessible from every page in the numpy docs. Note that I (arbitrarily) chose "Learn" for the link name, but that's probably confusing since there's alreadynumpy.org/learn
which points elsewhere. This could be added separately from DOC: Removing tutorials from sphinx documentation #19418 if desired.Illustrates an alternative to the approach taken in DOC: Removing tutorials from sphinx documentation #19418 to address DOC: Removing tutorials from sphinx documentation #19418 (comment) in particular. Instead of having
tutorials_index.rst
as a stub providing the user with a link tonumpy.org/numpy-tutorials
, we can instead add external links tonumpy-tutorials
directly to the toctrees/templates. This is similar to the pattern already used for the installation instructions (see e.g. the toctree insource/user/index
). The main advantage of doing it this way is that it requires one less click from the user and integratesnumpy-tutorials
more tightly with the numpy reference docs.This PR is just to illustrate ideas via the circleci build artifact, mostly to compare with #19418.