Documentation Link

https://matplotlib.org/devdocs/tutorials/introductory/images.html

Problem

I found several issues within this introductory tutorial and I believe those issues can be solved by rewriting the tutorial.

Issues:

• First, this tutorial was written prior to the depreciation of matplotlib.image.imread(), the current preferred method of opening images is usingPillow's Image.open(). The tutorial doesn't indicate this and reader's of the tutorial will see depreciation warnings when trying to go through the tutorial.
• Second, I believe this tutorial is quite lengthy for an intro on how to use matplotlib.pyplot.imshow(). I think it would be better not to overwhelm new users with paragraphs of information on image analysis techniques and theory. Linking to pages about these topics might save users time.

Suggested improvement

I am considering rewriting this tutorial but first I want to get an idea of how to rewrite it in a way that avoids adding too many details but also gives users a good introduction to imshow(). As this is the first time I've contributed here, I wanted to get input from others before I started this process.