Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Common navigation in the website of scipy projects #9277

Open
datapythonista opened this issue Sep 23, 2019 · 5 comments
Open

Common navigation in the website of scipy projects #9277

datapythonista opened this issue Sep 23, 2019 · 5 comments
Labels

Comments

@datapythonista
Copy link

We're discussing in numpy/numpy.org#43 about having common or similar navigation in different projects of the ecosystem, so for example users using numpy + astropy are not confused trying to find the same things with different names and different places in both projects.

I think Astropy navigation is not very far from what we've been discussing so far. May be you want to join the party? :)

@pllim pllim added the Docs label Sep 23, 2019
@pllim
Copy link
Member

pllim commented Sep 23, 2019

Hello! 😄

Are you referring to https://github.com/astropy/astropy.github.com or what Sphinx renders at https://astropy.readthedocs.io/en/latest/ ?

@datapythonista
Copy link
Author

datapythonista commented Sep 23, 2019

I refer to the top bar in https://www.astropy.org/, but probably even better if having it in both. Do you prefer me to open the issue in the other repo?

@pllim
Copy link
Member

pllim commented Sep 23, 2019

Thanks for the clarifications! I'll defer to the @astropy/coordinators . 😸

@bsipocz
Copy link
Member

bsipocz commented Sep 23, 2019

As I remember quite a lot of discussion and iterations has been put in the current top bar, so while it would be nice to have something more uniform along the wider ecosystem it would be rather nice to not divert too much from what we have now.

(To make docs.astropy.org and astropy.org share more of the top bar is in the works, the former will inherit them from the latter once the changes in the sphinx theme are merged. The longer term idea was to share that top bar more in the astropy ecosystem, as we have multiple packages etc.).

@embray
Copy link
Member

embray commented Apr 22, 2021

This is also related to #11520. Changing to the PyData sphinx theme would require some rewiring at least of docs.astropy.org to look more like https://numpy.org/doc/stable/ which has some top-level sections like "User Guide" "API Reference" "Development". It doesn't have to be the exact same layout necessarily but something like it.

The pandas docs are using a similar layout but also add "Getting Started" and "Release notes" to the top navbar: https://pandas.pydata.org/docs/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

4 participants