Add alt text to Dask docs

[scharlottej13]

Welcome!

This is the working PR for the Dask Community alt text mini sprint! This is where we collaborate during the event before we send a clean contribution over to the main repo.

How to contribute

For the full info about this event, please visit the HackMD agenda.

During the event, you can contribute alt text to any of the images on currently used in a blog post. Please contribute via suggestions so we can easily review each other's work.

If you plan to work on a file, let people know by commenting below. We can have multiple suggestions for the same alt text, but it would be nice if we spread out to cover more images.

If you think an image is missing from these files, let @scharlottej13 know and she'll add it to the PR.

Images in this PR

To make collaborating easier, comment below with the number of the image you'd like to work on. You can do this as a group, and you can write alt text for as many images as you'd like.

file: docs/source/logos.rst

• (example) line 6

file: docs/source/why.rst rendered docs

• 1. line 19
• 2. line 27

file docs/source/10-minutes-to-dask.rst rendered docs

• 3. line 376
• 4. line 394
• 5. line 410

file docs/source/array-chunks.rst rendered docs

• 6. line 270
• 7. line 277
• 8. line 299
• 9. line 315
• 10. line 322

file docs/source/array-design.rst rendered docs

• 11. line 7

file docs/source/array-overlap.rst rendered docs

• 12. line 35
• 13. line 41
• 14. line 48

file docs/source/delayed.rst rendered docs

• 15. line 25
• 16. line 113

file docs/source/develop.rst rendered docs

• 17. line 368

file docs/source/graphs.rst rendered docs

• 18. line 60

file docs/source/graphviz.rst rendered docs

• 19. line 37

file docs/source/optimize.rst rendered docs

• 20. line 62
• 21. line 101
• 22. line 117
• 23. line 137
• 24. line 154

file docs/source/order.rst rendered docs

• 25. line 104
• 26. line 141

file docs/source/shared.rst rendered docs

• 27. line 91
• 28. line 104
• 29. line 106
• 30. line 121

[isabela-pf]

Here's a proposed checklist for alt text style (may be helpful for review):

The alt text has

• Correct spelling and no typos
• Periods and commas where relevant
• No more than three short, complete sentences
• A logical way of fitting in the rest of the documentation
• Consistent text and/or descriptions for the same elements in different images
• A description of any text in the image

[martindurant]

Suggested change

:alt:

:alt: Two graph panels. Left: Cost of entire graph, Duration versus Number of edges per task. Dask.async and dask.threaded curves both increase linearly, with the latter consistently higher by at least a factor of 3. Right: Cost per edge, with the same axes. Both curves start from a high value for small number of edges, but reach an asymptote where dask.threaded is a factor of a few higher than dask.async .

[pavithraes]

I'm working on this!

[GenevieveBuckley]

Is this alt text referring to a different image? It doesn't seem like it goes with this one.

I was expecting something like "Dask task graph of ... blah blah blah" for alt text belonging to images/10_minutes_array_graph.png

[GenevieveBuckley]

Yes, this very definitely does not go with this image. I've added an alt-text suggestion for the actual image here below.

[GenevieveBuckley]

👍

[GenevieveBuckley]

👍

[GenevieveBuckley]

👍

[GenevieveBuckley]

👍

[GenevieveBuckley]

👍

[GenevieveBuckley]

👍

[GenevieveBuckley]

👍

[GenevieveBuckley]

👍