Change logo href from master_doc back to index

[leonarduschen]

I'm very new to using Sphinx documentation but as far as I know, there are generally 2 different ways to generate the index.html for Sphinx documentation landing page.

• Directly from index.rst - which is the more common and straightforward way. In this case, master_doc is set as index in conf.py
• Using a custom HTML template by adding html_additional_pages = {'index': '<template>.html'} in conf.py. In this case, master_doc is not index, but rather just whatever RST file containing the toctree root.

This creates 2 different logo-click behavior between documentation sites that use the former method (e.g. https://pydata-sphinx-theme.readthedocs.io/en/latest/) and documentation sites that use the later (e.g. https://numpy.org/devdocs/).

One project that would benefit from this change is NumPy as mentioned in this issue numpy/numpy#17211

Edit: Since Fairlearn documentation will also be affected, I have created an issue in Fairlearn to get their opinion on this fairlearn/fairlearn#570

[leonarduschen]

Relevant info documentation sites that are using pydata-sphinx-theme

master_doc is index

• This repo (https://pydata-sphinx-theme.readthedocs.io/en/latest/)
• Pandas (https://pandas.pydata.org/docs/)
• Bokeh (https://docs.bokeh.org/en/dev/)
• JupyterHub and Binder: https://docs.mybinder.org/, http://z2jh.jupyter.org/en/latest/, https://repo2docker.readthedocs.io/en/latest/, https://jupyterhub-team-compass.readthedocs.io/en/latest/
• Jupyter Book beta (not sure)

Using landing page HTML template (i.e. master_doc is not index)

• Fairlearn (https://fairlearn.github.io/quickstart.html)
• NumPy dev docs (https://numpy.org/devdocs/)