Update landing page #10674
Update landing page #10674
Conversation
This rips out most of the previous content. It focuses less on Dask's internal design / intent / architecture / goals, and more on how to use the project. I think (hope?) that the design also comes across a little more cleanly.
|
I've added a screen recording to the original comment so that people can get a sense for how it feels without building locally. |
|
|
||
| .. figure:: images/dask-overview.svg |
There was a problem hiding this comment.
I really like this figure, but probably introducing all of this on the docs homepage is not all that helpful. At quick glance it seems we also have it on 10 minutes to Dask and Scheduling, which are both a better fit.
There was a problem hiding this comment.
Can you say more about what you like about it?
There was a problem hiding this comment.
When I was newer to Dask I pretty much equated Dask with Dask DataFrame. Looking at this image helped orient me and answer questions like: how do all these collections fit together? what is "distributed"? why do I need to care about task graphs?
docs/source/index.rst
Outdated
| @@ -143,7 +315,7 @@ messy situations in everyday problems. | |||
| .. toctree:: | |||
| :maxdepth: 1 | |||
| :hidden: | |||
| :caption: Fundamentals | |||
| :caption: API | |||
There was a problem hiding this comment.
Maybe "Dask APIs"? Or something else to distinguish from the API reference lower down?
There was a problem hiding this comment.
Hrm, I agree with the concern (mildly agree at least). I'm not a fan of this particular solution though.
There was a problem hiding this comment.
I've made this "How to Use" for now
Co-authored-by: Sarah Charlotte Johnson <scharlottej13@gmail.com>
|
OK, I've given this a second pass. I think it's better than what we have today. I plan to merge tomorrow if there are no further comments. |
This rips out most of the previous content. It focuses less on Dask's internal design / intent / architecture / goals, and more on how to use the project.
I think (hope?) that the design also comes across a little more cleanly.
Screen.Recording.2023-12-05.at.1.08.19.PM.mov
cc @jrbourbeau @scharlottej13