Documentation of size parameter

[mjuopperi]

Various methods of the library take a size tuple with a doc string like "size – Requested size."

I assumed it would be (width, height), but finding it from documentation was needlesly complex. Only reference I found was
here.

Would it make sense to either improve documentation by changing the method docs to be clearer (e.g. "size – Requested size. (width, height)." or perhaps by using a NamedTuple or similar self documenting type?

[radarhere]

When you say "various methods", I only found draft() and thumbnail(). Are there more that I'm not seeing, or is that it?

[radarhere]

Thanks to #6851, draft() and thumbnail() have now been updated.

[mjuopperi]

• https://pillow.readthedocs.io/en/stable/reference/Image.html#PIL.Image.Image.resize
• https://pillow.readthedocs.io/en/stable/reference/Image.html#PIL.Image.Image.transform
  etc.

Image.new has proper documentation: "size – A 2-tuple, containing (width, height) in pixels."

[hugovk]

• pillow.readthedocs.io/en/stable/reference/Image.html#PIL.Image.Image.resize

This says:

size – The requested size in pixels, as a 2-tuple: (width, height).

That looks okay?

---

• pillow.readthedocs.io/en/stable/reference/Image.html#PIL.Image.Image.transform

This says:

size – The output size.

So that can be improved.

---

• etc.

More examples welcome!

[radarhere]

https://pillow.readthedocs.io/en/stable/reference/Image.html#PIL.Image.Image.transform has now been updated.