-
-
Notifications
You must be signed in to change notification settings - Fork 7.9k
DOC: new index page #20737
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
DOC: new index page #20737
Conversation
99c907c
to
38d5466
Compare
This is very bare-bones, but probably good for a start. I actually think it would be nice to add a cool image somewhere (probably the bottom), and the different sections could be put into boxes or something. But I'm not really sure about how fancy this has to be or whether the brochure page will point here, or just a level down. |
As much as I like the divio guide, I think I agree w/ you that learn vs understand doesn't make sense to someone not familiar w/ the framework & we probably need to contextualize, something like
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is a good start. I'm ok to merge as is (after CI pass).
1175a11
to
ca8c260
Compare
ca8c260
to
4d974bf
Compare
.. _jdh-fellowship: https://numfocus.org/programs/john-hunter-technology-fellowship/ | ||
.. _nf: https://numfocus.org | ||
How-tos | ||
======= |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Do we want to link the gallery here - the gallery has many examples of how to make plots, or are we differentiating that into learn how to do things with the library?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The gallery is already linked above under "Learn", so I was thinking it didn't need to be re-linked. I was also thinking that these "How Tos" could be more specific, and perhaps higher level than making plots. i.e. How to do things that help you make plots, but not "How do I make a line plot?"
PR Summary
Start on a landing page.
Closes #20735
PR Checklist
pytest
passes).flake8
on changed files to check).flake8-docstrings
and runflake8 --docstring-convention=all
).doc/users/next_whats_new/
(follow instructions in README.rst there).doc/api/next_api_changes/
(follow instructions in README.rst there).