DOC: Proposal - make the doc landing page cards more similar to scipy#21491
DOC: Proposal - make the doc landing page cards more similar to scipy#21491charris merged 5 commits intonumpy:mainfrom
Conversation
Co-authored-by: Stefan van der Walt <stefanv@berkeley.edu>
seberg
left a comment
There was a problem hiding this comment.
I think the changes are a pretty nice improvement. Especially, the fact that we uninentionally had a smaller width on all of the docs because of htat one small setting ;).
@melissawm, I guess this was good to just be merged?
|
Thanks Ross. Should (can) this be backported? I'm going to rebuild the 1.22 docs for 1.22.4. |
Yes I think this should be backported - it'd be nice to have consistent theming for the 1.22 and 1.23 docs. There shouldn't be any problems backporting, but I'll keep an eye on the CI of the backport PR! |
…/pandas (numpy#21491) * DOC: Add panel elements to index matching scipy/pandas. * DOC: Update card styling in css to match scipy/pandas. * DOC: Add release notes to nav bar. * DOC: replace css in layout with html_css_files conf val. * DOC: Fix page layout. Co-authored-by: Stefan van der Walt <stefanv@berkeley.edu> Co-authored-by: Stefan van der Walt <stefanv@berkeley.edu>
|
Hey @rossbar 👋 You can also see it in action now on the front page of https://myst-parser.readthedocs.io, https://myst-nb.readthedocs.io, and https://aiida.readthedocs.io Obviously, feedback is also welcome 😄 |
|
Thanks for the heads up @chrisjsewell ! The goal here is to stay coordinated with the card-layout on the front page of scipy & pandas - it'd be nice to coordinate the transition or synchronize once one of the projects migrates. Pinging @tupui and @jorisvandenbossche just so it's on some radars. |
This was discussed in the docs meeting and builds on #21456 . The proposal is to make the docs landing page look more like the pandas and scipy landing pages. The landing pages for these three projects already borrow heavily from one another - this PR just makes a few tweaks to bring numpy more in line stylistically with the other two. Main changes:
There's also one minor maintenance issue: we're currently loading the custom css by extending the main layout template. AFAICT that is the only purpose that extending the layout template currently serves (the other additions have been commented out - see #17220). I think it's more straightforward to use the sphinx
html_css_filesconfig value to accomplish this rather than loading the css in the base template. I've made that change in 08ae8d3 but if there are objections I'm happy to break that out into a separate PR.Also fixes #21264