Add alt text to scikit-learn documentation

[isabela-pf]

Welcome!

This is the working PR for the PyLadies SWFL, PyLadies Miami, and Python SWFL alt text mini sprint (that's a lot of words)! 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 @isabela-pf 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: doc/modules/biclustering.rst (Link to biclustering docs and rendered images)

• 1. Line 51 (image)
• 2. Line 64 (image)

File: doc/modules/calibration.rst (Link to the calibration docs and rendered images)

• 3. Line 56 (image)

File: doc/modules/clustering.rst (Link to the clustering docs and rendered images)

• 4. Line 36 (image)
• 5. Line 170 (image)
• 6. Line 187 (image)
• 7. Line 278 (image)
• 8. Line 317 (image)
• 9. Line 427 (image)
• 10. Line 470 (image)
• 11. Line 475 (image)
• 12. Line 503 (image)
• 13. Line 508 (image)
• 14. Line 611 (image)
• 15. Line 637 (image)
• 16. Line 656 (image)
• 17. Line 661 (image)
• 18. Line 711 (image)
• 19. Line 716 (image)
• 20. Line 721 (image)
• 21. Line 726 (image)
• 22. Line 751 (image)
• 23. Line 756 (image)
• 24. Line 761 (image)
• 25. Line 822 (image)
• 26. Line 908 (image)
• 27. Line 1051 (image)
• 28. Line 1543 (image)

File: doc/modules/covariance.rst (Link to the covariance docs and rendered images)

• 29. Line 157 (image)
• 30. Line 182 (image)
• 31. Line 215 (image)
• 32. Line 339 (image)
• 33. Line 344 (image)

---

If you need anything, please ask @isabela-pf or @MarsBarLee! 🌻

[isabela-pf]

Here's a checklist of a few formatting factors you can check for when reviewing alt text:

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

[MarsBarLee]

The link to my slides from earlier

Step by Step: How to Add Alt-text with Github Suggestions (example image below)

[isabela-pf]

Hey everyone! Just a reminder that I will close this PR soon to get it ready for submitting to the main repo. I'm planning to clean everything up and reply to the main issue in the next 24–48 hours, so it'd be best if you make any final submissions before then. I know I still want to write some 😆.

[isabela-pf]

Again, thank you to everyone who participated. I hope this was a good exercise for you (and maybe inspires you to write alt text on other projects)!

I'm closing this PR to open one on the proper scikit-learn repo and will link it here once the PR is up.

[isabela-pf]

It's PR time! Look at all you cool kids in the commit history! 🌻 scikit-learn#21354

Thanks again for taking the time to contribute.